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Give These Expanded ^ 
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^The ability to transfer data from any type of device to another (IEEE, Serial, 
Parallel) 

-k BASIC 4.0 which allows you to run more PET BASIC programs and gives you 
extended disk and I/O commands. 

^The ability to have several 64s on line together - sharing common IEEE 
devices such as disks or printers with Spooling Capability. 

if Built-in machine language monitor 

if A built-in terminal or modem program which allows the system to communi- 
cate through a modem to many bulletin board systems and other computer 
mainframes. 



^Compatibility with CP/M. 



Contact your local Commodore dealer or RTC. 
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Digital Research. POWER is a trademark of Pro- 
fessional Software. PAL is a copyright of Brad 
Templeton. 
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In a few millionths of a second, common electrical surses and spikes 
can enter your data processing equipment and cause memory loss, 
false logic and misregistratfon. Surges very often do permanent 
damage to microcircuitry. 

FLEXIDUCT Surge Suppressors catch surges and spikes before they 
have a chance to enter your equipment In billionths of a second 
(Nanoseconds),FLEXIDIKT Surge Suppressors dissipate surges and 
spikes from any side of the line (most protect only one side). 
The multi-outlet unit is ideally suited to the computerized work- 
station. It gives you the advantage of circuit breaker protection with 
plenty of outlets for data processor and peripheral equipment 
No computer should be v^thout the protection of a FLEXIDUCT Surge 
Suppressor...cspceially yours! Write or call for further information. 
Available from office products retailers. 



l2ZZZZZ^7® Surge Suppressors 

a product of Winders & Geist, Inc. P.O. Box 83088 Lincoln, NE 68501 402/474-3400 



No. 68 - January 1984 



MICRO 



/MCftO 



TM 



Editorial 



Communications 



The focus of this issue of MICRO is on 
communications: computer-to-computer over telephone 
modems -including program downloading and computer 
bulletin boards, and computer-to-computer 
communication via local networks. 

Remote Communications 

An original article by John Kelty on CoCo and the Hayes 
Smart Modem has been modified by Phil Daley to work on 
the Apple, Atari, and Commodore 64 as well. No matter 
which computer you own, you now have the software you 
need to run this popular modem. Walter Charlton has 
taken a different approach to add communications to his 
CoCo. MODCONN: The CoCo and Modem- to-Modem 
mmunication shows how to add RS-232 capability 
without fancy hardware. On the Commodore computers 
you have to use some tricks to download BASIC. Stone 
and Cornwall show how this may be done on the PET, VIC 
and C64. Part of Paul Swanson's column deals with 
Telecommunicating with your Atari and the use of free 
bulletin boards. 



Local Networks 

Randall Hyde provides a comprehensive introduction to 
local networking with in The Network Primer. He 
describes the seven-layered network, discusses several 
important network topologies, and then shows how these 
concepts are involved in one particular system, the 
NESTAR CLUSTER ONE. 

MICRO Communications 

One of the reasons for featuring communications at this 

time is that we are developing a MICRO Phone Service for 

subscribers. In addition to being a general purpose bulletin 
board for serious computerists, authors will be able to 
submit articles and programs, and subscribers will be able 
to download programs that have appeared in MICRO. 
Printed listings have always been a problem. The longer 
the program listing, the greater the chance of making 
typing errors. Once we have the MICRO Phone Service 
mnning, the only effect of length will be the cost of 
telephone connect time! We will have to establish some 
protocols for program loading, standards for assembler 
formats, and so forth. I would appreciate hearing from 
those of you who have had experience in this area. 
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$29.95 


21.00 
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24.95 


18,00 


Adventureland 


29,95 


?ino 


Pirates Adventure 


29.95 


21.00 


Golden Voyage 


29.95 


21.00 


Magic Window 


99.95 


72.00 


Temple of Apshai 


39.95 


29.00 
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15.00 
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29.95 
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34.95 


25.00 



Zork I 39.95 29.00 

Zork II 39.95 29.00 

Deadline 49.95 36.00 
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Supertext II 150.00 108 00 

Softcard Premium System 775.00 600.00 

Wizard and tlie Princess 32.95 24.00 
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59,95 44.00 

129.95 94.00 

59.95 44.00 
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24.95 18.00 

34.95 25.00 

34.95 25.00 

39.95 29.00 
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29.95 21.00 



Inlec 32K Board $75,00 

APPLE Compatible Disk Drive $265,00 

VERBATIM/DATALIFE Disks $26,00 



ATARI 
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Bandits (d) 
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Gorf (c) 
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Ghostly Manor (d) 

Raster Blaster (d) 
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Rear Guard (d) 

Rear Guard (t) 

Caverns of Mars (d) 

Atari Basic (c) 

Star Raiders (c) 
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MANY MORE PROGRAMS AVAILABLE 



TERMS; Send check or money order 
for total purchase price, plus $2.00 
for shipping. Ml residents add 4% 
tax. C.O.D. accepted. 

MFGS TRADEMARK 



VISA AND MASTERCARD ACCEPTED 



STROM « 



P.O. Box 197 
Plymouth, Mi. 48170 
(313) 455-8022 



SYSTEMS INC. 



WRITE OR CALL FOR FREE CATALOG 

PHONE ORDER HOURS 
4 PM - 9 PM MON.-FRI. 

INCLUDE CARD NUMBER 
AND EXPIRATION DATE WITH 

CREDIT CARD ORDERS. 
INCLUDE TYPE OF COMPUTER, 
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That s righf the positively perfec' PERCOM DATA SVi", floppy cfisk drtve with a BUILT-(N ' 
PRINTER PORT, for your Atari* 400 800 is r^ow availablei 
Until now, Atari computer owners who warted to hook a printer to their computer had only one 
choice... spend about $220 for an interface device THOSE DAYS ARE OVER PERCOM DATA has 
built a parallel printer-port rignt into its new AT88 PD n^odei Now you can ado a quality disk drive 
system AND have a place to plug in a printer WITHOUT BUYING an interface 
The Araa S1 PD '" disk drive operates in botn single density (88K bytes formatted) and double 
' density {176K bytes formatted) .-,t. 

■ What more cou'd you wanf? NO INTERFACE ahigh quality PERCOM DATA disk dnve ANDa 
built-in PRINTER-PORT all with a price of $599 
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printer port pronto' ' 

Fotthe name or an authorized PERCOM DATA Dealer near you, 
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You've got the loot ... now, GETAWAY! to a great 
new game from the Atari® Program Exchange! 







It's a// there! The squall of sirens, the crazy 
turns down endless city streets, the anxious 
search for ill-gotten gain, the race against 
time for a safe place to stash your cash! 
Now your gas tank is nearly empty and night 
is about to fall. The coppers are closing in 
fast. Before you learn again that crime 
doesn't pay. ..Quick! GETAWAY! 

Ask for GETAWAY! at your local Atari software 
retailer, or order direct. Phone 800-538-1862, or 
800-672-1850inCalifornia. Or write Atari Program 
Exchange, P.O. Box 3705, Santa Clara, CA 95055. 

Cassette(410) APX-10195 32K $29.95 

Diskette (810) APX-20195 32K $29.95 

For direct orders, add $2.50. 




You're in for a nasty spell ... unless you stop the Typos! 




In the dusky world beneath your 
keyboard the gruesome Typos dwell 
...waiting to attack! Term paperdue 
tomorrow? Got to get that book re- 
port typed? Fool! The Typos will 
devour your letters as you type! 
That could spell D-O-O-M-E for 
you! 

Before you start typing, get down 
to the real work: destroy the Typos 
before they destroy your proase... 



uh, proze...prrrose...Oh NO! THE 
TYPOS!!! Get TYPO ATTACK, a 

grand and glorious game from 
Atari® Program Exchange. It might 
even improve your typing! 

Ask for TYPO ATTACK at your local Atari 
software retailer, or order direct. Phone 800- 
538-1862, or 800-672-1 850 in California. Or 
write Atari Program Exchange, P.O. Box 
3705, Santa Clara, CA 95055. 
Cassette (410); APX-10180 8K $29.95 
Diskette (810): APX-20180 16K 529,95 
For direct orders, add $2.50. 



The 

Network 

Primer 

by Randall Hyde 



In the early sixties the integrated circuit was introduced. 
Engineers were delighted to pay $20.00 for a single DIP 
package containing four NAND gates, Due to the ex- 
pense involved, every device designed using these devices 
was optimized to use as few of these devices as possible. 
With every technological advance that came along the 
high price of silicon dropped dramatically. Today you can 
buy that same NAND gate for less than fifteen cents in 
suitable quantities. 

Since computers designed in the sixties required 
thousands of those $20.00 NAND chips, computers 
(specifically CPU's) designed at that time were very ex- 
pensive. Since CPU's were so expensive computer center 
administrators wanted to squeeze every bit of useful com- 
putational power out of their system as was possible. It 
was considered heresy to leave a computer idle. A million- 
dollar instrument sitting around idle was a very expensive 
waste of money. 

The same advances in silicon technology that gave us 
the fifteen cent NAND gate also gave us the micropro- 
cessor. It is now possible to buy a complete computer for 
less than $2.00 (Intel just announced an 8048-type 
microcomputer for less than $2.00 containing CPU, RAM, 
ROM, and I/O — everything you need for a complete com- 
puter system). Even considering a personal computer, 
such as the Apple 11 system, that sells for $1,000 to $2,000 
it becomes apparent that the CPU utilization is not very 
important — if the computer sits around all day with a 
blinking cursor waiting for input from the user, no big 
deal, for the same million dollars that bought the 
System/360 in 1965 you could buy 500 to 1,000 personal 
computers and get more through-put even if over three- 
quarters of the computers sat idle at any given time. 

There were only a few problems associated with using 
1,000 personal computers instead of a single, large com- 
puter. First, although the overall through-put is increased 
tremendously, certain compute-bound operations such as 
math-intensive floating point calculations will proceed 
much slower on a personal computer than on a larger com- 
puter complemented with a floating point instruction set. 
Second, while the price of the CPU has dropped 
dramatically, electromechanical devices such as printers, 
disks, tape drives, and other such devices haven't dropped 
in price by the same proportion (i.e., these devices are still 
relatively expensive). Lastly, with the big expensive com- 
puters several users and processes could communicate 
with one another and share databases. With the localized 
personal computer it is difficult, if not impossible, for dif- 
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ferent users to share a common database or communicate 
with one another. For this reason many computer depart- 
ments continue to purchase large computers instead of 
decentralized personal computers. 

The need to share peripheral devices is, of course, very 
important. While a single user may have the need to use a 
printer, he might not be able to justify the high cost of 
such a device for use at his work station alone, especially if 
it is a special purpose printer such as a letter quality 
printer that will be used infrequently. It would be much 
better if a lot of different users could have access to a single 
letter-quality printer. Since each user would only be using 
the letter quality printer a small fraction of the time, it 
would almost always be available for use whenever a user 
desired to print something on it. Since the printer is 
available to several users, instead of just one, its utiliza- 
tion would be much higher than if it were connected to a 
single work station. Using the same idea hard disks, real- 
time clocks, floating point processors, and other special 
devices would be much more cost effective if they could be 
shared amongst several users. 

Several manufactures have created special multiplex- 
ing devices that allow several personal computer users to 
share a particular hardware device. For example, CORVUS 
has a device called the CORVUS Constellation that lets 
several microcomputer systems share a CORVUS hard 
disk system. Other manufacturers provide black boxes 
that let several personal computer users share printers, 
tape drives, and other peripheral devices. While this 
approach lets personal computer users share peripheral 
devices (and to a lesser extent, share databases), it suffers 
from the drawback that it does not allow users to easily 
communicate with one another, nor does it let users share 
exotic peripherals for which there is no multiplexer available. 

The Answer: A Network 

To solve the problems inherent with a bunch of 
autonomous computers a technique employed by larger 
computers is employed: the computer network. A com- 
puter network is simply some medium that allows two or 
more computers to communicate with one another. In a 
very general sense, the RS-232 line is an example of a com- 
puter network since it allows computers to communicate 
with one another. Real-life computer networks usually use 
a different transmission scheme than RS-232, but the idea 
is exactly the same-some method for transmitting data 
between two computers is used. 

In general there are two types of computer networks: 
Remote networks and Local networks. A remote network 
is usually associated with large mainframe computers. 
Anyone who has connected to the SOURCE via TELENET 
or some other service has used a remote networking 
system. Remote networks are seldomly used as a means to 
share peripherals such as printers, hard disks, etc. since 
data transmission rates are very slow and the end user 
typically has little access to such device (so the hard copy 
output, for example, could be picked up). Remote net- 
works do allow access to shared data bases such as the UPI 
and API data bases and stock quotation from the DOW 
lONES and other financial systems. In general, however, 
remote networks are of little interest to the group of per- 
sonal computer users who wish to share a common set of 
peripheral devices and files. 



The local network is used to connect various devices 
that are located within a short distance of one another. For 
example, within an office building you might place a fast 
dot-matrix printer in the engineering lab, in the account- 
ing department, in the sales department, and in the shipping 
departments. Persons using a local network would send 
draft output to the printer nearest their workstation. A 
single letter-quality printer might be found in the sales 
department. Anyone could use the letter-quality printer by 
sending the data to the proper device. The choice of dot- 
matrix printer would be made simply by distance to the 
printer. The people in the engineering lab would probably 
use the printer in the engineering lab since it is closer 
(although if the printer in the engineering lab is tied 
up for a while output could be directed to the sales depart- 
ment's printer). 

The local network also lets several individuals share a 
single high-speed, high-capacity hard disk. This also 
allows several users to share a common database and other 
files. For special applications such as floating point opera- 
tions, a special floating point processor can be placed on 
the network and complex floating point operations can 
be loaded into the floating point processor for further 
calculations. 

Finally, a local network lets individual users com- 
municate with one another. Since, after all, a network is 
simply a medium of communication between two or more 
computers, two users can easily communicate by sending 
data from computer to computer. This allows conversa- 
tions to take place "CB" style over the network. 

Within a local network there are two types of users: 
clients and servers. A server is a computer system on the 
network (a computer system on the network is called a 
node) that provides a service to other nodes. For example, 
a file server may consist of a small computer system con- 
nected to a hard disk. It recognizes requests from other 
users in the system and reads data from (or writes data to) 
the hard disk. A client is some node that requests service 
from a server. For example, a typical user requesting data 
from the file server is a client of the file server. Note that a 
node can be both a server and a client. For example, the file 
server may become a client of a node containing a real- 
time clock in order to obtain information to "date-stamp" 
a file. 

The Seven-Layered Network 

Most of the modem network technology is directly 
attributable to researched performed by the Department of 
Defense and several major universities. A few years back 
the International Standards Organization (ISO) decided to 
create a draft containing several standards for implement- 
ing network systems. A subset of the standard (in one 
fashion or another] is implemented in almost all modem 
networking systems. Therefore, an understanding of the 
ISO model is extremely useful for understanding specific 
networking systems. 

The ISO model divides the basic networking system in- 
to seven major components or layers. Each successive 
layer builds on the layer just below it (see figure I). The 
physical layer is the electrical and mechanical specifica- 
tions of the networking system. For example, consider the 
RS-232 standard. Mechanically, a DB-25 connector is used 
with certain pins allocated certain functions. This is the 
8 MICRO 
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Figure 1: ISO seven-layer network model. 



mechanical specification of the RS-232 standard. Elec- 
trically, the signal is allowed to vary between Ov and -t- 12v 
for a logic one,- and between Ov and - 12v for a logical zero. 
These specifications are the electrical specs for the RS-232 
system (granted, somewhat abbreviated). The Physical 
Layer for any network system defines the connection in 
these terms, the connector used, voltage ratings, type of 
transmission (phase encoded, pure digital, analog, etc.), 
and other specifications of interest to the engineer wiring 
the system together. 

The Data Link Layer is responsible for the reading and 
writing of data to the network, error detection (and 
possibly correction), and the assembly and disassembly of 
data packets. More specifically, the data link layer is 
presented with a packet of data containing, in addition to 
the data to be transmitted, a destination address and other 
useful information. The data link layer adds a checksum 
(or other error-detecting scheme) to the end of this packet 
and transmits the data over the network. Note that the 
packet was given to the data link layer as a complete 
package, the data link layer did not have to assemble the 
packet a byte at a time. Likewise, when the data link layer 
reads data from the network it reconstructs the data packet 
transmitted and presents the higher levels with a com- 
plete, error-free packet of data. In the event an error is 
detected the data link layer disregards the entire transmis- 
sion and requests a retransmission. The higher layers are 
completely unaware of this. Most networks provided 
error-free data abdve the data link layer. 

The Network Layer is usually found only in the remote 
network systems. The purpose of the network layer to to 
insure that data packets move smoothly throughout the 
network system. In most remote network systems data 
packets being sent from system A to system C must first 
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When it's time to get serious, it's time to boot up 
MicroSpec business software. Our complete line 
of business software is made to give you some real 
applications for your Commodore 64. From data 
base management to full accounting software, we 
have the package for you. 

It's attention to detail that makes our packages 
so beautiful and makes them stand out from the 
rest. We realize that most people are first 
time users, so we designed all our packages to 
be completely menu driven and user prompt- 
ed for each input. We also know that most 
people use only one disk drive, so we 
designed all our packages to virtually 
eliminate disk swapping. Other features like 
non destructive input routines really make 
our software easy to use. But all this doesn't 
restrict you. Pure random access file struc- 
ture maximizes your disk capacity and 
allows you to bring up any record for viewing 
in less than a second. 

In our efforts to put together the best pack- 
ages available, we worked on more than the 
software. We took the same approach with the 
documentation as the software. We made it com- 
plete and easily understood for the first time user. 
We even provide sample reports in many cases. 
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The Demonstration Package, which shows how 
each program runs, is available for $19.95. So, if 
you're serious about your 64, call or write for a 
complete brochure or go right down to your 
nearest computer retailer for a demonstration. 



WHEN YOU AND YOUR 64 ARE READY TO GET DOWN TO BUSINESS 

GIVE US A CALL 
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pass through system B. Obviously the data being trans- 
mitted to point C is of little interest to the application pro- 
gram running on machine B, but due to the structure of the 
network system B must store and forward the data being 
received from system A on to system C. The network layer 
handles this problem as well as other problems associated 
with congestion and flow control. 

The Message/Transport layer concerns itself with 
machine-machine communications. The transport layer is 
responsible for taking a complete message and "transport- 
ing" it to the destination machine. Likewise this layer is 
responsible for accepting a message and presenting the 
whole message to higher layers in the protocol. 

The transport layer is responsible for taking a complete 
message, breaking it up into smaller packets (if necessary), 
and presenting these packets of data to the network (or 
data link) layer for transmission. This allows the higher 
layers to treat data strictly in terms of message units 
without having to worry about maximum message 
lengths, minimum messages lengths, the type of transmis- 
sion, etc.. Another responsibility of the transport layer is 
handling the type of communication. There are typically 
two types of transmission "modes": 



Virtual Circuits and Datagrams. 

Datagrams are very important in remote networks 
where each data packet can take one of several different 
routes. In a datagram model the network simply accepts 
messages and attempts to transport them to the destina- 
tion as a single unit. Datagrams may arrive out of order or 
not at all. The receiving station is responsible for col- 
lecting these datagrams, assembling them in their proper 
order, and making sure that all datagrams have arrived and 
are error-free. 

A virtual circuit attempts to treat the network system 
as though the source and destination stations were the 
only systems on the network. In this type of setup the net- 
work appears as a single circuit between the source and 
destination stations. Virtual circuits always provide an 
error-free transmission channel where no data packets are 
lost and they always arrive in the order they were 
transmitted in. Once the transmission is set up, all data is 
transmitted at which point the virtual circuit is discon- 
nected. Most local networks use some combination of vir- 
tual circuit/datagram service. 

The Session layer is the true user's interface into the 
network. The session layer is responsible for setting up a 
communication channel between users and tacking on the 
necessary address information for each packet trans- 
mitted. The session layer is also responsible for making 
sure the transmission of a message isn't terminated 
halfway through. For instance, a database management 
program would be completely destroyed if a session was 
terminated halfway through the update of a particular 
record. Typically, the session level would gather all the 
data required by a particular routine and present the 
message as a complete package, not allowing the system to 
continue operation until the entire package was received. 

The Presentation layer is typically a small collection of 
routines that handle data compaction, encryptionation, 
etc.. This layer is rarely implemented in local networks (or 
remote networks for that matter) . 
10 MICRO 



The Application layer is the user program making use 
of the network system. The definition of this layer is en- 
tirely up to the user. 

A Network System You've Used Since Childhood 

Believe it or not, you've been using a remote network 
for a good part of your life. Thanks to Alexander Graham 
Bell most of the people in this country, even those who've 
never seen a computer in their life, are well aquainted 
with the most important network of all: the telephone 
system. Bell labs (the R &. D portion of the Bell system) 
has put forth considerable research into optimizing the 
telephone system. Luckily, many of the concepts 
developed by Bell labs can be directly applied to computer 
networks. With this in mind, a discussion of the telephone 
system may be helpful before discussing computer networks. 

In many respects, the telephone system can be divided 
up into the seven layers just described for computer net- 
works. For example, at the physical level you have the 
connector plug in the wall, the allowable voltages, the 
number of wires, and (for all you modem fans) esoteric 
things like the ringer equivalence value. The data link 
layer is the circuitry required to handle the analog 
transmission from the mouthpiece to the telephone line. 
The network layer is responsible for picking out the route 
which the phone call will take [yes, sometimes a call from 
L.A. to San Francisco gets routed via Washington D.C). 
The transport layer defines a virtual circuit mechanism for 
data transmission (after all you do want the data to arrive 
in order, it would be uncool if you said "Hello there" and 
it came out "there Hello" at the other end). The session 
layer consists of the circuitry required during dialing and 
the maintenance of the virtual circuit during communica- 
tion. The presentation layer (if present] could be 
represented by one of those magic "black boxes" that the 
CIA uses to scramble and unscramble phone conversa- 
tions. And the applications layer is the actual phone con- 
versation taking place. As you can see, the OSI network 
structure provided by the ISO model is very general and 
easily re-worded to fit almost any communication system 
in existence. 

It was noted earlier that Bell Labs has done quite a bit 
of research into network structures, much of which has 
found its way into many of the modern network designs. 
This combined with the DOD's ARPANET, IBM's SNA, 
and other early networking systems has structured many 
of the modern networking systems including ETHERNET, 
OMNINET, NESTAR, and others. 

An Introduction to Local Networks 

The need for local networks grew from two basic 
desires: wanting to share expensive peripheral devices 
among several inexpensive CPU's and wanting to improve 
communication between various workstations. 

Consider the average sales office. At any given time 
you may have several secretaries using word processing 
stations, executives using some financial modeling system 
(VISICALC anyone?), salesmen checking stock and placing 
orders on computer terminals, and clerks maintaining the 
inventory using workstations in the warehouse. This 
much activity would bog any conventional timeshare 
system down tremendously. Could you imagine how 
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useful VISICALC would be if it took 20 seconds to perforin 
each calculation? So a timeshare system would be out of 
the question. Yet the individual members have to be able 
to share data, for example whenever a salesman sold 
something it would be nice if the stocking clerk was 
alerting so that he could order a replacement. Likewise, 
you wouldn't want two salesmen selling the same item if 
it is the last one in stock, or at least you would want to 
alert them so that they could advise the customer of any 
possible delays. By combining a group of small computers 
into a network it is possible to allow members of a 
organization to easily share computer data without the 
hassles of using a timeshare system. 

Since there is a need to provide many of the employees 
with access to some common data (like the number of 
items in stock) a bunch of isolated microcomputers won't 
be able to completely solve the problem. But if those same 
microcomputer systems could be connected together so 
that peripherals, data, and other communications lines 
could be shared the problem could be solved. Such wishful 
thinking lead to the development of the local network. 

The ETHERNET networking system is an example of a 
local network. The ETHERNET system allows office 
employees to share databases, peripherals, programs, 
"chat" between stations, share a single communications 
line (such as TELEX/TWX datacom lines), and have access 
to larger, expensive computer systems. ETHERNET 
features a high-speed data communications protocol that 
provides an almost instantaneous transfer of data. The 
problem with ETHERNET is that in addition to its high 
speed, it is also very high cost. A controller card for a 
microcomputer may well cost you $4000. When you stop 
and realize that one of the main reasons for using a net- 
work is to save the expense of putting a $2,000 printer at 
every station you begin to realize that ETHERNET is not 
yet cost effective. Luckily, there are alternatives to 
ETHERNET. 

The Shape of Things to Come: Network Topology 

A networking system is used to connect several com- 
puter systems together. Each computer system within a 
network is called a node or a station. There are all kinds of 
ways to connect several nodes together, any child playing 
with tinkertoys can attest to that fact. In a networking 
system there are various layouts possible when connecting 
a group of computer systems together; the layout, or 
graph, of the computer network is called the network 
topology. While there are infinitely many ways to connect 
up computer systems in a network there are three basic 
topologies from which most others can be derived. These 
topologies are the STAR, RING, and BUS (or tree) 
topologies. 

The STAR topology (see figure 2) consists of some cen- 
tral node through which all communication must pass. 
The STAR topology is probably the most obvious since 
this type of layout is used by large mainframes and mini- 
computers which are connected to computer terminals. In 
a networking system, if a node other than the central node 
wished to transmit data to any other, the transmission 
would have to go through the central node in order to 
reach the destination node. This form of communication 
has two drawbacks. First, if the central node goes down so 
does the whole network. Secondly, if the central node is 
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slow, the entire network will be slowed down since all 
communication must go through the central station. Even 
if the central node is fast, attaching additional stations to 
the system will cause severe network degradation since 
the central node becomes vastly overworked. The STAR 
topology does have one highly redeeming value. Much of 
the necessary connecting hardware is in place in many 
business offices-the PBX telephone system. The PBX (or 
private branch exchange) is the little operators console you 
find on the desk of the front receptionist in any large cor- 
poration. While intended to handle voice transmissions, 
most PBX's are easily upgraded to handle data transmis- 
sion. The PBX system is a good example of a network 
using the STAR topology. Since all the wires are already in 
place, many businesses will opt to use their existing 
equipment thus saving thousands of dollars in installa- 
tion costs. 

The RING topology (see figure 3) was developed mainly 
for remote networks between large computer systems. 
The basic idea behind a ring network is that data packets 
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are passed from machine to machine in a "hot potato" 
fashion until the data packet arrives at the destination 
system. Since few local networks use the RING topology, 
there's little need to discuss it any further here. 

The BUS topology (see figure 4) is the favorite topology 
amongst the various local networks. ETHERNET, OM- 
NINET, NET/ 80, SOFTWORKS, Z/NET, and most other 
local networking systems use some variation on the BUS 
topology. The BUS topology is high robust. Any compo- 
nent (with the unlikely exception of the connecting cable) 
in the network system can fail and the network will still 
operate. The BUS topology allows you to add and remove 
nodes at will [in some cases without powering the system 
down). The BUS topology has another big advantage: often 
the circuitry required is less expensive than that required 
for other networking topologies. 

Network topology is very important in remote net- 
works where delays due to routing can be significant. 
Many remote networks use a store and forward approach 
where one station transmits data to an adjacent station 
from which point it is transmitted on down the line. Since 
it takes time to receive and retransmit a package of data, 
delays grow proportionally to the number of systems in a 
ring topology network (ring topologies are in many large 
networking systems). Since the network nodes are stationed 
fairly close to one another in a local network, the bus 
topology is normally used. The bus topology removes the 
problem of routing delays, but requires special cables and 
hardware which would be much too expensive for widely 
separated stations. 
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Figure 4: Bus Topology. 



Data Transmission in a Networking System 

Since the same transmission medium is used by all the 
nodes on a network, some supplemental information must 
accompany each data transmission. For example, a 
destination address must be tacked onto every transmis- 
sion so that the intended receiver can recognize a data 
transmission. Other auxiliary information, such as a 
length field, type field, acknowledgement field, and 
checksum may be tacked onto the data. 

A block of data containing the necessary source, 
destination, checksum, data, and other optional fields is 
12 MICRO 



called a frame or data packet. Data packets are constructed 
at each level in the network protocol. For example, the ap- 
plication layer sends data (possibly a character at a time) to 
the session layer where it is sent to the message /transport 
layer with a destination and source address. The 
message/transport layer collects the data until a complete 
frame is constructed, adds any required length, type, and 
other necessary fields and passes the data packet to the 
data link layer for transmission. The data link layer adds 
the checksum and any necessary acknowledgements and 
transmits the data over the network. 

One important feature of a networking system is its 
data transmission rate. The data transmission rate is 
usually measure in bits per second (BPS) which is also 
called BAUD. For example, the familiar 300 BAUD line 
used in telecommunications is a three hundred bits per 
second data transmission rate. Many remote networks 
operate at 300 BPS and 1200 BPS (using leased lines). 
These data rates, however, are very slow. Most local net- 
working systems operate in the range of one to twenty 
MBPS [megabits per second) which is 1,000 to 60,000 
times faster than the lines used by the remote networks. 
The maximum data transmission rate of a networking 
system is called its bandwidth. Even though a network is 
capable of operating at 1 MBPS, the medium can operate at 
300 BPS if need be. 

In almost any networking system there isn't constant 
traffic on the net. So although a cable (or whatever) is 
capable of handling data at high speeds, the average data 
transmission rate is usually much lower than the band- 
width of the transmission medium. If the average band- 
width is low because no one is transmitting data, it's no 
big deal. After all, the average network user isn't in- 
terested in the quality of the cable being used to connect 
nodes, he's only interested in response time. If the average 
data transmission rate is only 50 BPS on any given day, but 
users get instantaneous response then things are just fine. 
But if the network is noisy, congested, or has some other 
problems, many packets will have to be retransmitted 
thus cutting the average transmission rate and the 
response time down considerably. 

At any given time only one data packet can be in the 
process of being transmitted over a single circuit. If two 
nodes attempt to transmit over the same wire at the same 
time both transmissions will be garbled up and the 
transmission will be completely invalid. Such an occur- 
rence is called a collision. Collisions occur most often in a 
network using a bus topology since must nodes in such a 
system share the same transmission circuitry. Receiving 
stations have no way of determining if a collision has 
occurred. If fact, the only time a receiving station can 
determine that a collision has occurred is when it performs 
some sort of error check and the checksum doesn't match. 

One of the major problems with a collision is that the 
entire data packet must be retransmitted. Which means 
that the average data transmission rate is reduced. This is 
compounded by the fact that data transmissions occur 
asynchronously. That is to say anybody can start trans- 
mitting whenever they please. So halfway through your 
transmission someone else could start talking and wipe 
out your entire message. This problem is easily solved by 
by first listening to the bus to see if anybody else is 
transmitting. If someone else is using the transmission 
medium you wait until they are through. If there is no traf- 
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fie on the network then you can start transmitting. This 
method, called the Carrier Sense Multiple Access (CSMA) 
improves efficiency tremendously. CSMA does not com- 
pletely eliminate collisions, but it does cut them down 
tremendously. 

A collision can still occur if two stations happen to 
look at the bus at the same time and find that the carrier is 
absent. Since data transmission takes place at somewhat 
less than the speed of light there is a finite (although 
small) time delay between the time a station puts a carrier 
signal on the network and it travels to all the stations. 
This time, although measure in microseconds, is quite 
long compared to the cycle time of a typical personal com- 
puter. For example, in a normal local networking system 
this time interval, called the round-trip transmission time 
might be 30-60 microseconds. If two nodes attempt to 
transmit data within one round trip transmission time 
there will probably be a collision. Collisions in a CSMA 
collision detection system are quite rare unless there is an 
enormous amount of traffic on the network. 

An Introduction to the NESTAR CLUSTER ONE 

There are hundreds of different networking 
arrangements, with new ones being introduced everyday. 
Therefore, in order to discuss some specific details a 
specific system must be discussed. The remainder of this 
paper will concern itself with the NESTAR 
CLUSTER/ ONE MODEL A local networking system. 

The Cluster/one lets you connect up to 64 Apple II 
computers together in a local network. Each Apple is inter- 
faced to the system via a plug-in card that attaches to the 
Apple's bus. This circuit card contains the necessary inter- 
face circuitry as well as IK of RAM and 2K of ROM. Nodes 
in the Cluster/one network are interconnected with 
16-conductor cable similar to that used to attach disk 
drives to an Apple n. 

The Cluster/ one transfers data at 240 KBPS, quite slow 
for a local network. Slow, however, is a relative teim. 240 
KBPS is roughly 1,000 times faster than the 300 BAUD 
lines used by the SOURCE and other telecommunications 
systems. 240 KBPS is the maximum data rate sustainable 
by software methods using a 1 Mhz 6502. By comparison 
Xerox's ETHERNET transfers data at 10 MBPS yet the cir- 
cuitry required to support ETHERNET is better than ten 
times the cost of the Cluster/one. In general, the 240 
KBPS is fast enough. To put it into concrete terms, you 
can transfer 64K of data in less than four seconds using a 
240 KBPS data transfer rate, that's much faster than a 
floppy disk or printer. 

The Structure of the NESTAR System 

The NESTAR Cluster/one implements three of the 
lowest four levels defined by the ISO reference model of 
Open Systems Interconnection (OSI). These are the 
physical, data-link, and message/transport layers. The 
networking layer is usually not present in a local network, 
and is absent from the Cluster/one networking system. 
The remaining layers (session, presentation, and applica- 
tion) are either supplied by the user or left 
unimplemented. How the lower layers are implemented is 
determined by the configuration of the network and the 
software purchased with the system. 
14 MICRO 



One of the most important network design considera- 
tions is the network topology. The Cluster/one normally 
uses the bus topology. Due to the structure of the hardware 
almost any topology can be accommodated. Typically, 
however, the bus topology is used because it is the least 
expensive and the software was designed with the bus 
topology in mind. 

A typical NESTAR consists of several user stations 
(clients) and one or more file server stations. A file server 
consists of a dedicated Apple computer with an 8" floppy 
or 14" hard disk. All the other users on the net share the 
resources provided by the file server. The disk drives sup- 
ported by the Cluster/ one provide 1.2 megabytes to four 
Gigabytes of disk storage using one or more drives on the 
system. In addition to the file server, the dedicated Apple 
also provides a clock/ calendar server so that files sent to 
disk can be "time-stamped" with the creation and update 
time. The Cluster/one network interface cards were 
designed using low-cost non-critical components in an 
effort to keep the total package cost down. It would be in- 
sane to require a $4,000 interface card on a computer 
system that only costs $2,000 (don't laugh, Intel is selling 
ETHERNET interface cards for $4,000). The network in- 
terface was optimized for low-cost and reliability at the ex- 
pense of speed. As mentioned previously, the bandwidth 
of the NESTAR system is quite low. 

The Cluster/one interface card uses a passive interface. 
This gives you the ability to power up and power down 
stations on the net without adversely affecting the net- 
work. It also allows you to add new nodes to the system 
without having to power the system down or even halt 
network communications. In the event of a station failure, 
the network may continue to function providing the con- 
troller card itself isn't damaged. In many topologies [like 
the ring and star topologies) the failure of one or more sta- 
tions can shut the whole network down. In the case of the 
Cluster/one, the net will continue to function as long as at 
least two stations are functional. 

The NESTAR system using a 16-conductor cable to 
connect nodes in the net. This is the second unusual 
feature to the Cluster/ one system, most local networks 
use a twisted pair or coax cable (two conductors). Of the 
16-conductors, eight are used to transmit data in a byte- 
serial fashion. By transmitting the data eight bits at a time 
the effective bandwidth is increased by eight. Although 
the system is transferring data at around 240 KBPS, the 
data is actually being transferred at a data rate of 30 KBPS 
on any given data wire. This gives the 6502 roughly 34 
cycles in order to perform the necessary checksum calcula- 
tions and store the data in memory or fetch the next byte 
from memory. An additional line is used for the carrier 
signal. When active, someone is attempting to use the net- 
work, when inactive the network is free and ready for 
transmission. Three of the remaining seven lines are used 
for handshake using the standard data available/data 
taken/ready to accept handshake protocols. The remain- 
ing four lines are signal grounds. 

To transmit data over the network a controller card 
first checks to make sure everyone is listening and then it 
places the data on the bus. The data available line is set ac- 
tive and the destination node senses the data available line 
and reads the data off of the bus. Once the data is read the 
data taken signal is set active and the source station may 
transmit additional data. Due to the structure of the net- 
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work, it's real easy to reverse the direction of the data lines 
and acknowledge a data transmission. This fact is used by 
the NESTAR software to handle frame acknowledgements 
as will soon be pointed out. 

The Cluster/one system is highly tolerable of 
transmission errors. First of all its low bandwidth allows 
inexpensive flat ribbon cable to be used instead of expen- 
sive coaxial cable. Secondly, rather than use extra-cost 
passive terminators in the system, the software was 
designed to accept unterminated connections by providing 
a software delay whenever data was placed on the bus. 
This delay allowed all the ringing and echoes to die down 
before attempting to read the data on the bus. By running 
at such a slow data rate [30 KBPS/conductorJ many of the 
problems associated with transmission lines is avoided. 

All data transmitted over the NESTAR CLUSTERBUS 
(a possibly trademarked name for the 16-conductor inter- 
connect) is transmitted in a purely digital form. No phase 
encoding (like that used by ETHERNET) is performed, nor 
are the signals converted to some type of analog signal 
before transmission. This simplifies the data conversion 
process and likewise lowers the cost of the NESTAR system. 

The NESTAR Data-Link Layer 

The data-link layer in the Cluster/one is implemented 
in hardware and firmware. The software required for the 
data-link layer is contained in the 2K byte ROM on the 
NESTAR interface card. The data-link layer is responsible 
for transmitting data onto the net and accepting data from 
the net. The data link layer attaches a checksum to the end 
of a transmission and checks the checksum value at the 
end of a transmission. It is responsible for handling 
retransmissions in the event the data wasn't transmitted 
properly. The data link layer is also responsible for media- 
access scheduling, addressing, flow control, and conges- 
tion control. To sum it up, the data link layer is respons- 
ible for providing error-free data transmissions between 
two stations on the network. 



Tiansmitting data: 

The data link layer is presented with a data packet from 
the transport layer. The data packet is of variable length 
and consists of 4n bytes where n is the number of bytes of 
data to transmit. The first byte transmitted is the source 
address. This is used to detect a collision on the Cluster- 
bus. If two stations attempt to place their source addresses 
on the bus at the same time at least one of the transmitting 
stations will recognize a collision since all source ad- 
dresses are different. If a collision does occur, all stations 
recognizing the collision will jam the bus to make sure 
that everyone else sees the collision as well. The data-link 
layer only checks for collisions during the first few bytes 
of transmission. Later collisions during the transmission 
of the data frame are highly unlikely since the carrier 
signal is checked before attempting to transmit data. In 
the case some station erroneously transmits data a 
checksum error will occur and both packets will have to be 
retransmitted. By not checking for collisions after each 
transmitted byte, the data transmission rate is increased. 
After the cable has been allocated (by placing the 
source address on it) the source station places the destina- 
tion address on the bus and, after a suitable delay, ac- 
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tivates the carrier control line. On the active edge of the 
carrier control line hardware on each of the interface cards 
triggers an address comparator that compares the address 
on the Clusterbus to the source address of the particular 
card. If a match is made then the software in the destina- 
tion interface will be activated in order to read the data 
packet being transmitted. 

After the destination address is placed on the bus and 
accepted by the source station, the type and length bytes 
are transmitted. Following the length byte, "length" bytes 
of data are transmitted over the network. During the 
transmission of the type, length, and data bytes the source 
station is constantly computing a checksum. At the end of 
the data transmission the 16-bit [two byte] checksum is 
transmitted over the network. 

Once the checksum is transmitted the data packet 
transmission is complete-almost. The only thing remain- 
ing is to make sure that the data packet was properly 
received. In order to check that the data packet was cor- 
rectly sent the source station reverses its data lines and 
becomes a receiver. The destination station transmits a 
single byte containing a ACK (acknowledgement) or NAK 
(negative acknowledgement) code. If a NAK code is re- 
ceived then the source station retransmits the data frame 
beginning with the type field. If an ACK code is received 
then the source station frees the network bus by setting 
the carrier line inactive. 



Data Reception: 

Receiving data is almost the converse operation to 
transmission. Data reception begins when the destination 
hardware recognizes its address on the bus. Once the 
destination hardware accepts the destination address from 
the bus it reads the type and length fields respectively. The 
destination interface software begins calculating the 
checksum with the receipt of the type byte. Once the 
length byte is accepted the destination station reads that 
many data bytes from the bus. After the data bytes are read 
two checksum bytes are read and the final checksum is 
checked. If the checksum is ok then the destination sta- 
tion transmits an ACK code to the source station. After the 
ACK is transmitted the destination station goes on about 
its business. If the checksum didn't match, then a NAK 
code is transmitted to the source station and the destina- 
tion station waits for a retransmission. 

Congestion and flow control are also taken care of by 
the data-link layer. Flow control (making sure the source 
doesn't transmit data any faster than the destination can 
receive it) is handled automatically by the hardware. A 
new byte isn't transmitted until the old one is taken. Flow 
control isn't quite that simple however. For example, if a 
destination station is powered down in the middle of a 
transmission the source station would be left hanging in a 
locked-up state if a timeout mechanism was not provided 
for. Checking for timeouts also comes under the heading 
of flow control since making sure that the destination sta- 
tion is accepting the data fast enough is just as important 
as making sure the transmitting station doesn't transmit 
data too fast. This prevents stations from monopolizing 
the network if for some reason they decide to start accept- 
ing data at only one byte per minute. 

Congestion control is possibly more important than 
flow control in the Cluster/one. Congestion control deals 
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with preventing too many users from accessing the net- 
work at any given time. Congestion control is handled in 
one of several methods. Since the Cluster/one uses a 
CSMA collision detection the number of collisions is 
reduced tremendously. Whenever a large number of sta- 
tions start wanting to use the bus, however, the number of 
collisions rises dramatically. While the bus is jammed and 
garbage is being transmitted the average data transfer rate 
is sorely reduced. Worse than that, it's reduced at the time 
it's needed the most when there are a lot of stations re- 
questing network service. 

When a collision is detected, the stations recognizing 
the collision back off of the network (i.e., attempt to set 
the carrier line inactive) and jam the bus so that all sta- 
tions on the Clusterbus recognize the collision. Once the 
jamming is complete each station attempting to transmit 
waits a small, random amount of time and tries again. It 
should be obvious why a random amount of time is used, 
if everyone waited the same amount of time a collision 
would be sure to re-occur. By waiting a random amount of 
time (instead of a fixed, but different, amount of time) all 
stations will be given equal priority on the bus. Another 
responsibility of the congestion control is to make sure 
that a pair of stations don't hog the bus. As you will soon 
see it is possible to hold the carrier line active while 
several data frames are transmitted. The congestion con- 
trol portion of the data-link layer is responsible for making 
sure no one hogs the bus for too long. 

The Message/Transport Layer 

The next layer of protocol in the Cluster/one system is 
the message/transport layer which manages the handling 
of messages and conversations among stations. Due to the 
fact that the length of a data packet is limited to 260 bytes 
(256 bytes of data, two bytes for type and length, and a 
two-byte checksum) data must be transmitted in a 
datagram fashion. Remember, in a virtual circuit opera- 
tion the source and destination stations connect just once 
and then all data is transmitted across the line until the 
transmission is complete. In a datagram system data 
packets, or datagrams, are transmitted a block at a time 
with the receiving station making heads or tails of the 
received data. Since you can transmit a maximum of 256 
bytes in a data frame on the Cluster/one the system is 
limited to datagram service. Since, in the Cluster/one, 
datagrams are always transmitted in order and are never 
lost, a sort of "pseudo-virtual circuit" operation can be 
achieved by transmitted datagrams back and forth be- 
tween two stations. 

The simplest form of communication is a one-way, 
single-packet transmission [the datagram). Datagrams in 
the NESTAR system are always acknowledged (as dis- 
cussed in the section on the data-link layer). One-way 
communications, however, are only moderately useful. A 
truly useful communication system requires a series of 
two-way communications. This type of virtual circuit 
operation is easily accomplished by sending datagrams 
back and forth between the two stations. Such action, of 
course, requires a certain amount of cooperation between 
the two stations. 

One of the more interesting features of the Cluster/one 
system revolves around the canier line. By leaving this 
line active inbetween packet transmissions a multiple 
16 MICRO 



packet transmission can be accomplished without any in- 
terruption on the bus. While this does provide a small in- 
crease in performance (especially when the packets being 
transmitted are small). What's more important is that the 
data frames can be exchanged without interruption. This 
very important operation allows the construction of in- 
divisible operations like the ' 'set and test" instructions re- 
quired by operating systems. Thus, semaphores can be 
efficiently implemented in the NESTAR network. Care 
must be taken, however, to make sure that two processes 
don't accidentally hog the bus. As was previously men- 
tioned, the data-link software checks certain time-out 
counters to make sure that the current process isn't 
hogging the Clusterbus. 

Network Transparency 

One of the most important features of a hardware 
system like a network is that it must be totally transparent 
to the user. A networking system would be absolutely 
useless if you had to throw away all the software you've 
written and start over again to satisfy the network re- 
quirements. Such a horrible thought need not come true, 
due to the structure of the network itself, it is perfectly 
possible to treat the network as though all the devices at- 
tached to the network were, in fact, attached to the in- 
dividual work station. This concept of virtual I/O makes 
the system completely transparent to the end user. He 
need not change the way he thinks about the file system or 
I/O. Almost all of the existing software will run un- 
modified on the network. And the modifications required 
to adapt existing single-user applications for a multiple- 
user environment are easy to make. 

Some of the stations on the network (the servers) are 
designed to serve other stations (the clients). The printer 
server is a good example. This consists of an Apple II at- 
tached to a printer connected to the network. From the 
user's point of view he need only type PRl (from BASIC) or 
OPEN(F, "PRINTER:"!; (from Pascal) in order to access 
the printer. Everything else is handled by the network and 
patches made to the resident operating system. The only 
difference is that the printout comes from the printer 
server instead of the peripheral connected to slot one in 
the users Apple. 

To the Apple user the most important feature the 
Cluster/one offers is that it forces very little change on 
current work habits. The system is easily learned and the 
software enhances productivity through its combined 
computational and communication facilities. In any cor- 
porate structure communication is essential. A group of 
widely separated computer systems doesn't enhance com- 
munication throughout the corporation. Unfortunately, 
although a timeshare system provides the communica- 
tions capabilities response time is not very good. The 
Cluster/one network allows several microcomputer 
system to communicate with one another while maintain- 
ing the excellent response time microcomputer owners are 

used to and without obsoleting existing software. 

/MCftO' 
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Tired of typing in a listing from a friend 
or having to travel to a friend's place to 
copy a program you would like? If so, 
continue reading. This article explains 
a simple method to send and receive 
BASIC programs (or machine language 
programs with a BASIC loader) over the 
telephone using a VIC, C-64 or PET. 
Equipment requirements are minimal, 
consisting of the microcomputer and 
compatible modems connected to the 
serial port of the VIC or C64 or the IEEE 
port of the PET. The program trans- 
ferred is sent as a listing and automatic- 
ally converted by the dynamic 
keyboard technique to tokenized (pro- 
gram) form by the receiving computer. 
After communication, the received 
program can be readily run, or saved to 
cassette or disk. Programs can be 
received from any other system. 

Kevin Stone, VIC enthusiast, is a 
former Equipment Technician for 
CNCP Relecommunications, and is 
currently a Technical Support 
Representative for Victor (Canada) Ltd. 
Kevin resides in Halifax, Nova Scotia, 
Canada. 

Andrew Cornwall, is a PET hobbiest 
with a wide range of interests in 
microcomputer applications. He is 
Secretary of the Nova Scotia 
Commodore Computer Users Group. 
He resides in Dartmouth, Nova Scotia, 
Canada. 
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Sending a Program 



The first step in transferring a pro- 
gram is to coordinate the modems at 
the sending and receiving ends. As 
usual for any commimication, one 
modem should be in the originate and 
the other in the answer mode (for the 
Bell 103 standard modem] . Although it 
does not seem critical, we prefer setting 
both modems at full duplex, if there is 
a duplex option. 

To send a program, load it into the 
transmitting computer's memory in 
the usual way (either from tape or disk, 
or direct entry). Once telephone con- 
tact has been established between 
modems, the transmitting computer 
lists the program to its modem device. 
The procedure to do this is slightly dif- 
ferent for the VIC or C64 and PET, and 
each is described separately below. 
Note that if only a portion of a program 
is to be transferred, the LIST command 
would contain the appropriate line 
number references (e.g. LIST 50-, LIST 
50-100, etc.). 

VIC or C64 Transmit 

In direct mode, type the following lines 
and hit return after each. Serial port 
parameters are set by CHR$(6) at 300 
baud, no parity with 8 data bits, full 
duplex, 1 stop bit, and three line hand- 
shake. This will work with most 
modems, but some may require 
slightly different parameters. 
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OPEN 2,2,0, CHR$(6) 
CMD2 

LIST (with line range if 
required) 

The program will now be sent over the 
modem as a full listing - not in 
tokenized form. When listing is finish- 
ed, indicated by return of the screen 
cursor, wait about 15 seconds (or if the 
modem has a transmit light, until this 
light stops flickering) for the serial port 
buffer to empty to the modem, then 
type in: 

PMNT2 
CLOSE 2 

This redirects normal output to the 
screen and closes the file. 

PET Transmit 

Enter the following lines in direct mode 
and hit return after each. The open 
statement assumes that the modem is 
device number 5, a common but not 
universal modem device number. Use 
the correct number for your system. 

OPEN 5,5 

CMD5 

LIST 

When listing is finished and the screen 
cursor returns, enter: 

PRINTS 
CLOSE 5 

Transmission Time 

The time needed to send a program is 
governed by the modem baud rate. At 
300 baud, transmission requires about 
30 seconds per kilobyte of listing. Since 
a program listing can be as much as 
twice as "long" as its tokenized pro- 
gram form, a 4K program in memory 
can take up to four minutes to transmit 
as a listing. 

Receiving a Program 

The receive method uses the dynamic 
keyboard append technique. While the 
routines for the VIC, C64 and PET are 
somewhat different, the general idea is 
the same. In each case a program listing 
is taken in and appended line-by-line to 
the small receive program. When the 
process is completed, the total program 
in memory consists of the receive 
routine plus the communicated pro- 
gram. The receive routine can be 
removed by using a toolkit delete com- 
mand or simply by entering the line 
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numbers for the routine and hitting 
return after each. 

As with any append process, the 
line numbers of the program being 
transmitted should not overlap those in 
the receive routine. If the line numbers 
do conflict, then simply renumber the 
program. The GOTO's must be fixed 
along with the renumbering. So long as 
overlapping line numbers is not a prob- 
lem, we prefer using the receive routine 
with low line numbers, since it is 
technically faster (and easier to 
delete!). 

Upon being run, the receive routine 
will ignore all transmitted characters 
I such as the word READY sent after the 
CMD command) until a numeric 
character with a value 1 to 9 is en- 
countered. The routine presumes that 
the first numeric character is part of the 
initial line number of a listing, and 
commences to take in the remainder of 
the listing after a valid number is 
received. 

At some point in the routines 
dynamic keyboarding takes over to 
carry-out the listing-to-program append 
process. This is visible as each com- 
municated program line appears on top 
of the screen, a transfer line (ending 
with a GOTO statement) is printed 
under it, next READY flashes once, the 
screen clears and the sequence starts 
over. This will continue until the word 
READY, which is automatically sent at 
the end of the listing, is encountered. 
At this point the process will stop with 
a harmless OUT OF DATA ERROR. 

VIC and C64 RECEIVE Programs 

These routines take advantage of the 
serial port 256 byte input buffer, which 
makes the timing of the receive and ap- 
pend processes less critical, although 
on average the routine keeps up with 
the character input rate at 300 baud. 
Upon being run the routine clears the 
screen and waits for the listing to be 



transmitted. When listing starts the 
action of dynamic keyboarding can be 
seen on the screen. The routine 
simultaneously receives and appends 
the incoming program listing. The 
buffer prevents data being lost during 
the dynamic keyboarding phase of the 
receive/append process. 

Although the input buffer takes 
only 256 bytes, the actual serial port 
buffer occupies 512 bytes. The addi- 
tional 256 bytes is for a transmit buffer, 
which is not used when receiving. After 
allowing for the buffers and receive 
routine itself, only about 2K of 
memory is available on a basic VIC for 
the received program. The routine will 
work with any memory expansion 
configuration however, without 
modification to the routine. 

Receive Program Detail 

LINE 0: OPENS a file to the serial 
port. CHR$(6) sets port parameters to 
300 baud, no parity with 8 bits, full 
duplex, 1 stop bit, and 3 line hand- 
shake. These parameters are 
appropriate for most common 
modems. The screen is then cleared. 
LINE 1: GETS a character via the 
modem and tests for receipt of first 
numeric character 1 through 9. 
LINE 2: PRINTS first received 
numeric character to screen. 
LINE 3: GETs via the modem and 
PRINTS across the screen. End of pro- 
gram line is determined by receipt of a 
carriage return. 

LINE 4: PRINTS dynamic 
keyboard transfer line to the screen. 
POKE 152,1 tells the VIC/C64 that one 
file remains open; GOTO 6 instructs 
the routine to restart at LINE 6 when 
the transfer line is executed in 
simulated direct mode. 
LINE 5: Fills keyboard buffer 
locations 631 to 634 with a home 
cursor and three carriage returns; POKE 
198,4 tells the VIC/C64 that the 
keyboard buffer contains four 
characters. After this the routine is for- 



VIC 



GOTO 



OPEN 2,2,0,CHR$(6):PRINT 

1 GET A*! IF VAL(A*)=0 THEN 

2 PRINT A*; 

3 GET #2,A*iPRINT A*;: 

IF A$<>CHR*(13) THEN 3 

4 PRINTiPRINT "POKE 152,liG0T0 6" 

5 POKE 631,19:P0KE 632,13:P0KE 633,13: 
POKE 634,13:P0KE 198,4;END 

6 PRINT "n"!;GOTO 3 
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mally instructed to END. In fact, 
however, the routine continues as the 
characters in the keyboard buffer are 
executed (simulating direct mode 
operation) which enters (appends) the 
transmitted program line printed to the 
screen and activates the transfer line. 
LINE 6: Clears the screen in 
preparation for the next received line. It 
then executes a GOTO 3 to continue 
the input. 

Using Other Line Numbers 

Since many programmers use the 
convention of starting at LINE 10, the 
above routine which resides from LINE 
to LINE 6 should not normally be in 
the way of the program being transfer- 
red. If there is a conflict, then simply 
renumber the BASIC program, 
remembering to change the line 
numbers for the three GOTO 
commands in lines 1, 4 and 6. 

PET Receive Program 

The PET IEEE port does not have an in- 
put buffer. As a result, when 
simultaneous receive and conversion is 
attempted, incoming characters are 
missed during dynamic keyboarding. 
To overcome this problem, the receive 
and conversion operations are done 
separately. First, the listing is received 
and POKE'd verbatum into a protected 
area of memory above 2K. When receiv- 
ing is finished, sensed by a 64 milli- 
second time-out error, the listing is 
automatically PEEK'd from memory 
and dynamic keyboard appending 
commences. 

Overall, the PET routine is slower 
than the VIC/C64 version, since it 
takes about an extra second per line to 
perform the separate appending pro- 
cess. Another disadvantage is that in- 
itial storage of the full listing requires 
as much as twice the memory as its 
counterpart in tokenized program 
form. Very large programs, however, 
can be communicated in stages, saved, 
and appended together afterwards. 

When run, the PET routine clears 
the screen and prints the message 
"READY TO RECEIVE". When a 
listing is being received, the message 
"RECEIVING" is printed. When the 
receiving is completed, i.e. a READY is 
received, the dynamic keyboarding 
takes over. 

PET Receive Program Details 

LINE 0: POKE 53,8 sets top of 
BASIC memory at 2K to protect higher 
memory for character storage. It then 
OPENs a file for device number 5, 
which is presumed to be the modem 
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From Skyles 
Electric Works, the 
oldest and largest 
professional 
specialists in the 
business. 



Skyles Electric Works 

231-E S. Whisman Road 
Mountain View, California 94041 




More speed, more memory 
workspace from the people 
who lifted the 64K limit. 

In 1981, we introduced our famous 
Saturn RAM card to boost the Apples 
memorY by 32K. Now, there are 64K 
and 128K versions for added power 

Increased RAM lets you run bigger 
programs, and our VisiCalc® expansion 
software provides a dramatic expansion 
of workspace memory Also, the extra 
memory can work as a pseudo disk for 
instant access. (No more 20-second 
searches!) The Saturn RAM board is a 
super aid for advanced word process- 
ing, data base management, spread 
sheet, and accounting applications. 
And perfect with PASCAL, CP/M®, 
and BASIC 




Use our easily installed cards in 
combination — and get a whopping 
220K of VisiCalc workspace on the 
Apple He. Or sensational enhancements 
on Apple II, II + , Franklin, Basis and 
most Apple compatibles. We even have 
softwcire that increases your Apple's 
memory in BASIC programming up to 
4 megabytes! 

This kind of performeince requires 
sophisticated bank switching and sup- 
porting software that we originated, 
proved, and improved. Buy from 
the leader! 

Let us help you expand your Apple's 
productivity. For information on our 
RAM boards and other Titan microcom- 
puter products, see your computer 
dealer or contact: Titan Technologies, 
Inc., PQ Box 8050, Ann Arbor, 
MI 48107; Telephone (313) 973-8422. 

Sales and Marketing by The MARKETE^G 
RESOURCE GROUP, Costa Mesa, CA. 



^a Titan 

" "" — TECHNOLCXJIES, INC. 

-^^^^^^^^^^^ FORMERLY SATURN SYSTEMS OF MICHIGAN 

Apple is a registered trademark of Apple Computer, Inc. 
VisiCalc is a registered trademark of VisiCorp, Inc. 
CP/M is a registered trademark of Digital Research, Inc. 



PET 



POKE 53,8:0PEN 5,5:J=2048: 
PRINT "uREADY TO RECEIVE" iQQTO 3 

1 GET#5,A*!lF STOO THEN GOTO 5 

2 J-JM:PGKE J , ASC (A$) ;6QTQ 1 

3 6ET«5,A»: 

IF STOO OR VAL(A$) 
=0 THEN GOTO 3 

4 PRINT "RECEIVINQ"!GOTO 2 

5 POKE 53,1288K=J:J=2048:CL0SE 5 

6 PRINT "C"; 

7 J=J+1:BX=PEEK(J);PRINT CHR*(BX);: 
IF B'/.<>13 AND K>J THEN GOTO 7 

8 PRINTiPRINT "K="K" : J=" J" : GOTO 6" 

9 POKE 623,19:P0KE 624,13!P0KE 625,13: 
POKE 626,13:P0KE 158,4:END 
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device number. Variable J is initialized 
to the 2K boundary. The screen is 
cleared and the message "READY TO 
RECEIVE" is printed. 

LINE 1: GETs a character from 
the modem and tests the status variable 
ST for an error. If an error occurs, it is 
assumed to be a time-out error (ST = 2], 
and branches to the dynamic keyboard 
section of the program, starting at LINE 
5. 

LINE 2: Increments variable J and 
POKES the PET-ASCn value of the 
latest character received into memory 
location J. Branches back to LINE 1 to 
get another character. 

LINE 3: Tests for receipt of first 
numeric character to suppress READY 
and other non-BASIC lines. 
LINE 4: PRINTS message 

"RECEIVING", after the first numeric 
character is received. 
LINE 5: Restores the normal top 
of BASIC memory. Defines variable K 
as last value of J, and redefines J as 2K. 
CLOSES file number 5. 
LINE 6: Clear the screen. 
LINE 7: PEEKS listing from 
memory and PRINTs characters across 
the screen. End of program line deter- 
mined by carriage return ( = 13) . 
LINE 8 PRINTS dynamic 

keyboard transfer line to the screen. 
The transfer line carries over the values 
of K and J and set the program to restart 
at LINE 6. 

LINE 9: Fills keyboard buffer 
locations 623 to 626 with a 'home 
cursor' and three 'carriage returns'; the 
POKE 158,4 sets a variable to tell the 
PET that the keyboard buffer contains 
four characters. After this, the routine 
is formally instructed to END. In fact, 
MICRO 



the routine continues as the characters 
in the keyboard buffer are executed, 
simulating direct mode operation to 
enter (append) the received program 
line printed to the screen and to 
activate the transfer line. 

Reliability 

Even though this method for transfer- 
ring programs does not use any error 
detection, such as parity checking or 
checksum, we found it to be very 
reliable. Phone line glitches can cause 
difficulties, but these were rare during 
our development and testing of this 
technique. On one occasion someone 
dialed an extension telephone while a 
program was being transmitted. On 
another, the phone line mysteriously 
went dead for several seconds. Normal 
phone line backgroimd noise and cross- 
talk did not seem to cause any pro- 
blems. In our "formal" testing of this 
procedure, an 8K listing was com- 
municated ten times over the period of 
several days. Each time the program 
was transferred successfully. Although 
our experience was on a local call basis, 
long distance telephone program 
communication should be feasible. 

If a problems occurs when a VIC or 
C64 is receiving a program, the routine 
can be rerun to accept that portion of 
the program listing which was not 
received correctly. If a problem occurs 
while a PET is receiving, the correction 
procedure is more difficult. That por- 
tion of the program received in good 
condition can be saved and the routine 
rerun to take in the listing of the re- 
mainder. Afterwards, both parts can be 
appended together. It is probably more 
convenient to simply re-do the entire 
procedure from the beginning. 
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•^FEATURING PROGRAMS 
FOR THE VIC-20 AND 
THE COMMODORE 64. 



!>J 



\ 



BOUNTY HUNTER 



$24.95^ 



An adventure in the Old West Journey back with 
us into the days of Jessie James and Billy the Kid 
where the only, form of justice was a loaded 
revolver and a hangman's noose. In this full-length 
text adventure, you play the role of Bounty Hunter, 
battling against ruthless outlaws, hostile Indians, 
wild animals and the elements of the wilderness 
with only your wits and your six gun. Average 
solving time: 20-30 hours. If you love adventures, 
this one is a real treat. 

Available for COMMODORE 64 and the VlC-20 
(with 8K or 16K expander). Available on TAPE or 
DISK Played with JOYSTICK 



KONGO KONG 



$24.95^ 



Climb ladders, avoid the barrels the crazy ape is 
rolling at you, and rescue the damsel. Commodore 
64 version features 4 different screens! 
Available for COMMODORE 64 and VlC-20. 
Available on TAPE or DISK Played with JOY- 
STICK 



^ GRAVE ROBBERS 



$19.95' 



Introducing the first GRAPHIC ADVENTURE 
ever available for the VIC-20 or COMMODORE 64! 
With realistic audio-visual effects, you explore an 
old deserted graveyard and actually see the perils 
that lie beyond. 

Available for COMMODORE 64 and VTC-20. 
Available on TAPE or DISK Played with KEY- 
BOARD. 



FT 



CHOMPER MAN 



$24.95 



Don't let the bullies catch you as you gobble the 
goodies! This program has 8 screens and still fits in 
the standard memory. 

Available for COMMODORE 64 and VIC-20. 
Available on TAPE or DISK Played with JOY- 
STICK or KEYBOARD. 



Victory 
Software 



WOULD LIKE TO WISH OUR CUSTOMERS 
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AND THANK THEM FOR THEIR 
PATRONAGE THROUGHOUT THE YEAR 



THE . EARTH • WARRIOR 



METAMORPHOSIS 



You stumbled into the nest of the Cyglorx and 
find yourself fighting off robot tanks guarding 
the Cyglorx eggs. You think you have everything 
under control and then the eggs start hatching. 
Available for COMMODORE 64 and VIC-20. 
Available on TAPE or DISK Played with JOY- 
STICK 
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CREATOR'S REVENGE 



$24.95 



The creator assembled a massive army of robots and insects to take 
revenge on the earth. Destroy insects, get treasures, and get the neutron 
bomb deactivator. Battle robots and destroy the neutron bomb before it 
annihilates your city. Miss and you must face the mutants. Features 4 
different screens. 

Available for COMMODORE 64. Available on TAPE or DISK Played 
with JOYSTICK 



[ LABYRINTH OF THE CREATOR $24.95* 




Journey into the most complex and dangerous 
fortress ever built by the creator. You will en- 
counter deadly robots, skulls, lakes, avalanches, 
false creators, and a creature who roams 256 
rooms relentlessly pursuing you. 
Available for COMMODORE 64. Available on 
TAPE or DISK Played with JOYSTICK 



ILLUSTRATIONS: EU2ABETH HAUCK 



$3.00 additional for disk. 



Check your LOCAL DEALER or order directly. 

ORDERING: We accept personal checks, money orders, VISA, and MasterCard. 

Charge orders please include number and expiration date. 

OVERSEAS ORDER: Please use charge, or have check payable through a U.S. 

bank. 

CANADIAN CUSTOMERS: If you wish to write a check drawn through a 

Canadian bank, please multiply the total order by 1.25 for proper conversion. 

Add $1.50 postage and handling per order. PA residents please add 6% sales tax. 



VICTORY SOFTWARE INC. 

7 Valley Brook Road 

Paoli, Pennsylvania 19301 

(215) 296-3787 





Telecommuni cations 

with a difference! 

Unexcelled communications power and 
compatibility, especially for professionals and 
serious computer users. Look us over; SuperTerm 
isn't just "another" terminal program. Like our 
famous Terminal-40, it's the one others will be 
Judged by. 

• EMULATION— Most popular terminal protocols: 
cursor addressing, clear, home, etc. 

• EDITiNG— Full-screen editing of Receive Buffer 

• UP/DOWIMLOAD FORMATS-CBM, Xon-Xoff, 
ACK-NAK, CompuServe, etc. 

• FLEXIBILfTY— Selert baud, duplex, parity, stopbits, 
etc. Even work off-line, then upload to system! 

• DISPLAY MODES-40 column; 80/132 with 
side-scrolling 

• FUNCTION KEYS -8 standard, 52 user-defined 

• BUFFERS— Receive, Transmit, Program, and Screen 

• PRINTING— Continuous printing with Smart ASCII 
interface and parallel printer; buffered printing 
otherwise 

• DISK SUPPORT— Dirertory, Copy, Rename, Scratch 

Options are selerted by menus and EXEC file. Software 
on disk with special cartridge module. Compatible with 
CBM and HES Automodems; select ORIG/ANS mode, 
manual or autodial. 

Write for the full story on SupeiTerm; or. If you 
already want that difference, order todayl 

Requires: Commodore 64 or VIC-20, disk drive or Oausette, and 
compatible modem. VIC version requires 16K memory expansion. Please 
specify VIC or 64 when ordering. 



Smart ASCII Plus . . . $59'^ 

The only Interface which supports streaming —sending 
characters simultaneously to the screen and printer — with 
SuperTerm. 

Also great for use with your own programs or most 
application programs, i.e., word processors. Print modes: 
CBM Graphics (w/many dot-addr printers), TRANSLATE, 
DaisyTRANSlATE, CBMArue ASCII, and PIPELINE. 

Complete with printer cable and manual. On disk or cassette. 



VIC 20 and Commodore 64 are trademafks of Commodore Electronics, Ltd. 




DOSPLUS 
For C-64 



By Michael Keryan 



DOSPLUS — adds new utility 
functions to a Commodore 64 
by use of the RESTORE icey. 
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MICRO 



This article shows how to use the 
RESTORE key (which generates 
a Non-Maskable Interrupt) to ac- 
cess up to 32 new utility routines. 
Seven new functions are implemented, 
including versatile printer support, 
easy color changes, and a two-key 
append hinction that will allow you to 
combine two or more BASIC programs. 
The framework is provided to allow 25 
more functions to be added. 

The Commodore 64 is definitely 
one of the best values in home com- 
puter hardware. It is roughly com- 
parable to IBM's PCjr at about one- 
fourth the cost. Why is it so inexpen- 
sive? For one thing. Commodore de- 
cided to use the same BASIC-in-ROM 
interpreter that was used in the VIC-20 
and older PET machines. The KERNAL 
ROM was updated for the 64 but no 
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new BASIC commands were added to 
support the 64' s outstanding soimd, 
bit-mapped graphics, sprites, etc. To 
use these features you are left with a 
myriad of PEEKs and POKEs that in no 
way can be described as user-friendly. 
For example, to change the background 
screen color to black, you must type: 
POKE 53 281,0. To get a printed listing 
of a program, you type: OPEN 4,4: 
CMD 4: LIST, then afterwards: PRINT 
#4: CLOSE 4. An almost unbelievably 
complex series of POKES is necessary 
to program sprites and music. 

A number of third-party software 
packages have attempted to solve some 
of these problems by adding new com- 
mands to BASIC, e.g. Ultra-BASIC 64. 
However, there is always some 
desirable function missing. For exam- 
ple, Ultra-BASIC 64 provides graphic 
screen dumps to the printer, but has no 
normal jalphanumericj printer dump. 
Quite a few single-purpose machine 
language routines have appeared in 
magazines such as this recently which 
provide desirable add-on features. In- 
variably, these routines are placed 
either in the cassette buffer or at 
$C000, and require the SYS function 
to operate. 

The most convenient way to access 
handy functions involves assigning cer- 
tain keys or sequence of keys to the 
new functions. The DOS WEDGE (pro- 
vided on the demo disk that comes 
with Commodore's 1541 disk drive) 
uses this technique. For example, in- 
stead of typing LOAD"$",8 then LIST, 
you type only $ to get a directory 
listing. In general, however, assign- 
ment of special keys makes your pro- 
grams run slower since the absence or 
presence of these key sequences must 
continually be checked. 

The Powerful RESTORE Key 

This article provides a framework to 
add a series of extensions for the Com- 
modore 64 using the RESTORE key, 
followed by another key to define the 
function. Normally when you hit the 
RESTORE key, you use it in conjunc- 
tion with the RUN/STOP key, most 
likely to regain control of your com- 
puter when a program has gone into 
never-never land. However, hitting 
only RESTORE appears to have no ef- 
fect — a virtually worthless key. 

Actually, RESTORE is probably the 
most powerful key on the keyboard, 
and is ideally suited to controlling the 
computer. It provides a Non-Maskable 
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DOSPLUS BY M. J. KERYAN 

DUPLICATES NMI ROUTINE AT 
*FE43 IN ROM, CHECKS FOR 
KEY PRESS AFTER RESTORE KEY 











■ 1 ROM 


UTILITIESj 












INITl 


* «E518 












INIT2 


■ *FD15 












INIT3 


« *FDA3 












STPFL 


- «F6BC 












CONTNM 


■ *FE72 












STOP 


■ *FFE1 












GETIN 


- »FFE4 












CIAIRQ 


■ *DDOD> FOR RS/232 CHECK 










TABL 


« *CBCO; LOW BYTE POINTER 










TABH 

■ 


- *CBEO; HI 


BYTE POINTER 










ORIGIN 


■ *C900 












» ■ ORIGIN 






C900 


48 






NEMNMI 


PHA 




SAVE REGISTERS 


C901 


8A 








TXA 






C902 


48 








PHA 






C903 


98 








TYA 






C904 


48 








PHA 






C905 


A9 


7F 






LDA 


«*7F 




C907 


8D 


OD 


DD 




STA 


CIAIRQ 


IRQ FLAG FOR 


C90A 


AC 


OD 


DD 




LDY 


CIAIRQ 


1 RS/232 


C90D 


30 


35 






BMI 


RS232 




C90F 


20 


BC 


F6 




JSR 


STPFL 


FLAG SET 


C912 


20 


El 


FF 




JSR 


STOP 


STOP KEY? 


C915 


DO 


OF 






6NE 


NOTSTP 


NO, BRANCH 


C917 


20 


15 


FD 


STOPKY 


JSR 


INIT2 


DUPLICATE NMI 


C91A 


20 


A3 


FD 




JSR 


INIT3 


ROUTINES 


C91D 


20 


18 


E5 




JSR 


INITl 




C920 


20 


47 


C9 




JSR 


INITNM 


NEW INITIAL 


C923 


6C 


02 


AO 




JMP 


(«A002) 


; WARM START 


C926 


58 






NOTSTP 


CLI 




ENABLE KEYBD 


C927 


20 


E4 


FF 


KEYLP 


JSR 


GETIN 


GET A KEY 


C92A 


C9 


00 






CMP 


1*00 


WAIT/PRESSED 


C92C 


FO 


F9 






BEQ 


KEYLP 




C92E 


29 


IF 






AND 


#*1F 


MASK FOR 32 


C930 


AA 








TAX 




UNIQUE KEYS 


C931 


BD 


CO 


CB 




LDA 


TABL,X 


GET LO BYTE 


C934 


8D 


3E 


C9 




STA 


»+io 


SET UP JSR 


C937 


BD 


EO 


CB 




LDA 


TABH,X 


HI BYTE 


C93A 


8D 


3F 


C9 




STA 


»+5 




C93D 


20 


FF 


FF 




JSR 


*FFFF 


MODIFIED ADDR 


C940 


78 








SEI 




IRQ DISABLED 


C941 


68 








PLA 




GET BACK Y 


C942 


48 








PHA 






C943 


A8 








TAY 






C944 


4C 


72 


FE 


RS232 


JMP 


CONTNM 












jiNITIALIZATION ROUTINE FOR NMI 










NMINV 


« *0318 


KERNAL NMI VEC 










IBSOUT 


" *0326 


KERNAL CHROUT 










BRDCLR 


« *D020 












BCKCLl 


" *D02l 












COLOR 


» ♦0286 


CURSOR COLOR 










COLCH 


= *00 


CHARS « BLACK 










COLBK 


= *0C 


DACKG = GREY 


C947 


A9 


00 




NITNM 


LDA 


#<NEWNM 


[ ; RESTORE NMI 



MICRO 
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C949 


8D 


18 


03 


STA 


NMINV 




C94C 


A9 


C9 




LOA 


«>NEWNMI : 


VECTOR TO 


C94E 


8D 


19 


03 


STA 


NMINV+1 i 


NEW ROUTINE 


C951 


A9 


OC 




LOA 


#COLBK 




C953 


8D 


20 


DO 


STA 


BRDCLR ! 


EDGE COLOR 


C956 


8D 


21 


DO 


STA 


BCKCLl ; 


BACKGROUND 


C959 


A9 


00 




LDA 


#COLCH 




C95B 


80 


86 


02 


STA 


COLOR i 


CHARACTERS 


C95E 


A9 


71 




LOA 


«<NEWOUT 




C960 


8D 


26 


03 


STA 


IBSOUT 




C963 


A9 


C9 




LDA 


#>NEWOUT i 


NEW OUTPUT 


C965 


8D 


27 


03 


STA 


IBSOUT+1 ; 


VECTOR 


C968 


EA 






NOP 






C969 


EA 






NOP 


i 


FUTURE 


C96A 


EA 






NOP 


1 
1 


EXPANSION 


C96B 


A9 


00 




LDA 


#*00 ; 


PRINTER OFF 


C96D 


8D 


BB 


C9 


STA 


PFLAG 




C970 


60 






RTS 







C971 
C972 
C975 
C977 
C979 
C97B 
C97D 
C97F 
C980 
C983 
C984 
C985 
C986 
C987 
C98B 
C99A 
C980 
C990 
C992 
C995 
C997 
C99A 
C99D 
C99F 
C9A1 
C9A4 
C9A7 
C9AA 
C9AC 
C9AF 
C9B2 



48 

AD BB C9 

C9 04 

DO 3D 

A5 BA 

C9 08 

FO 37 

68 

80 BA C9 

48 

8A 

48 

98 

48 

A9 7E 



20 C3 
20 CA 
A9 7E 
20 BA 
A9 00 
20 BD 
20 CO 
BO OB 
A2 7E 
20 C9 
AD BA 
20 CA 
A9 7E 
20 C3 
20 CC 
68 



NEW OUTPUT ROUTINE 

VECTORS OUTPUT TO PRINTER IF 
PFLAG IS SET IN ADDITION TO 
CRT — DISK ACCESS WILL TURN 
OFF PRINTER ACCESS 



;KERNAL ROUTINES 



CLRCHN 




♦ FFCC 


OLOOUT 




♦ FICA 


CLOSE 




♦ FFC3 


SETLFS 




♦ FFBA 


SETNAM 




♦ FFBD 


OPEN 




♦ FFCO 


CHKOUT 




$FFC9 



VICMCR = *D018 
FA = *BA 
PFILE = *7E 



NEWOUT 



PCLOSE 



PHA 
LDA 
CMP 
BNE 
LOA 
CMP 
BEQ 
PLA 
STA 
PHA 
TXA 
PHA 
TYA 
PHA 
LDA 
JSR 
JSR 
LOA 
JSR 
LDA 
JSR 
JSR 
BCS 
LOX 
JSR 
LOA 
JSR 
LDA 
JSR 
JSR 
PLA 



PFLAG 

«$04 

RTNP 

FA 

«»08 

RTNP 

PTEMP 



;VIC MEM CTRL REG 
{CURRENT DEVICE « 
jLOGICAL PTR FILE 



;CHECK FLAG TO 

jSEE IF PTR IS 

jACTIVE 

;IF DEVICE IS 

;IS DISK THEN 

iOISABLE PRINTER 



iSAVE REGISTERS 



#PFILE 

CLOSE 

PCASE 

#PFILE 

SETLFS 

#*00 

SETNAM 

OPEN 

PCLOSE 

«PFILE 

CHKOUT 

PTEMP 

OLDOUT 

«PFILE 

CLOSE 

CLRCHN 



5FIRST CLOSE FILE 
jSET U/L CASE 



}CLOSE ON ERROR 



CHAR TO PRINTER 



; RESET TO CRT 
jRESTORE REGS 



Interrupt (NMIJ request to the com- 
puter's CPU. No matter what the com- 
puter is doing at the time, it will stop 
and jump to a special machine language 
program that determines why the inter- 
rupt was requested, and takes ap- 
propriate action. 

The Commodore 64 NMI program 
basically does two things: 

1. It determines if the NMI request 
came from the RS/232 port or from 
the RESTORE key. If the RS/232 
port generated it, the data transfer 
is handled. 

2. If the RESTORE key generated the 
interrupt, the NMI program checks 
to see if the STOP key was also 
pressed. If so, it jumps to initializa- 
tion routines and then to a BASIC 
warmstart. If the STOP key wasn't 
pressed, the program has no 
noticeable effect. 

So when you press the RESTORE 
key alone, nothing appears to happen, 
but actually the NMI program was ex- 
ecuted. Commodore makes it very easy 
to replace their NMI program with one 
of your own, since the NMI routine 
vectors through RAM locations 
$0318-0319. Place the locations of your 
new NMI program in $0318-0319 and 
you've gained complete control of the 
computer through the RESTORE key. 

Using the Piogiam 

An assembler program (Listing 1) il- 
lustrates how the RESTORE key can be 
used to add 32 new functions to the 
Commodore 64. To gain access to these 
new routines, press the RESTORE key 
followed by a second key that identifies 
the function. Seven new routines are 
provided in the Listing; twenty-five 
more are possible. The seven functions 
are as follows: 



A to Append programs 


R to change the Background color 


C to change the Character color 


E to change the Edge color 


D to Dump the current screen to 


the printer 


P to turn on the Printer 


to turn Ofif the printer. 
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MICRO 



Any other key pressed will return the 
computer to normal execution. Using 
the RUN/ STOP and RESTORE keys 
together function as normally, except 
vectors are restored to the new routines. 
Since this interrupt technique in- 
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volves no character checking during 
normal program execution, it won't 
slow down your programs. An unex- 
pected benefit of using the RESTORE 
key is that it also acts as a PAUSE or 
NO-SCROLL key. When a program 
listing or data is scrolling by too fast to 
read, just hit RESTORE — this will 
freeze everything until you hit another 
key. To resume the scroll, press 
RETURN. Also, the RESTORE func- 
tions can be stacked. Suppose you just 
stopped a scroll by using RESTORE, 
and you would like a printout of the 
current screen. Just hit RESTORE a 
second time, followed by D to generate 
the screen copy. Then hit RETURN to 
continue scrolling. This is an obvious 
advantage over using STOP, etc. 

The series of machine language 
routines reside in upper memory, pro- 
tected from BASIC, Reset, etc., at loca- 
tions $C800-CBFF. This is right next to 
the DOS WEDGE 5.1 utility program 
($CCOO-CFFF). Therefore the new 
routines (called DOSPLUS) can be 
loaded and initialized along with the 
WEDGE. Each routine is now described 
briefly. 

Non-Maskable Interrupt Routine 

The new NMI routine duplicates 
many of the functions of the original 
NMI routine located in ROM at $FE43. 
The CPU registers are saved and a 
check is made for an RS/232 interrupt. 
If the NMI request came from the 
RESTORE key, a check of the STOP 
key is made. If STOP was pressed at the 
same time, then three ROM initializa- 
tion routines are run. A new initializa- 
tion routine, INITNM, is then run 
(more on this later), followed by a 
warm start to BASIC. 

Assuming you had only pressed the 
RESTORE key to access the new func- 
tions, the initializations and warm 
start are bypassed. The interrupt flag 
is cleared to allow keyboard entry. 
Then the program waits for a key to be 
pressed. The upper 3 bits of the ASCII 
value of the key are masked to zeroes, 
so only 32 unique keys are possible. 
Based on the value obtained above, 
pointers for the corresponding routines 
are set up into a JSR statement, then 
the JSR is taken, in which the new 
function is executed. After the 
subroutine is run, program flow returns 
to the old NMI routine in ROM which 
restores the registers and executes an 
RTI [return from interrupt) and normal 
program execution resumes. 
No. 68 - January 1984 



C9B3 
C9B4 
C9B5 
C9B6 
C9B? 
C9BA 
C9BB 



C9BC 
C9BE 
C9C0 
C9C3 
C9C4 
C9C6 
C9C9 



C9CA 
C9CD 
C9CF 
C9D1 
C9D3 
C9D5 
C9D7 
C9D9 



C9DA 
C9DD 
C9DF 
C9E2 
C9E4 
C9E7 
C9EA 
C9EC 
C9EE 
C9F1 
C9F3 
C9F5 
C9F7 
C9F9 
C9FC 
C9FF 
CA02 
CA04 
CA07 
CA09 
CAOC 
CAOF 
CA12 
CA14 
CA16 
CA18 
CAIA 
CAIC 
CAIE 
CA20 
CA22 



AS 

68 

AA 

68 

4C CA Fl 

OD 

00 



A9 04 

85 BA 

8D BB C9 
60 

A9 00 

OD BB C9 
60 



AD 18 DO 
29 02 
FO 04 
AO 07 
DO 02 
AO 00 
A2 04 
60 



20 CA C9 

A9 7D 

20 BA FF 

A9 00 

20 BD FF 

20 CO FF 

BO 7A 

A2 7D 

20 C9 FF 

A9 00 

85 FD 

A9 04 

85 FE 

20 89 CA 

20 7E CA 

20 97 CA 

A2 19 

20 El 

FO 5D 

20 75 

20 91 

20 8D CA 

AO 00 

01 FD 

C9 22 

DO 02 

A9 27 

C9 A2 

DO 02 

A9 A7 

8D BA C9 



TAY 

PLA 

TAX 

PLA 

JMP QLDOUT ;RTS THRU OLDOUT 

•BYTE $0D 

.BYTE $00 



RTNP 

PTEMP 
PFLAG 

■ 

TURN PRINTER ON/OFF 

PRNTON LDA #*04 

STA FA 

STA PFLAG 

RTS 
PRNTOF LDA #$00 

STA PFLAG 

RTS 



iACTIVATE BY P 



jACTIVATE BY 



DETERMINE IF SCREEN IS UPPER OR 
LOWER CASE--SET X AND Y 



PCASE 



UPPER 
PDEV 



LDA VICMCR 

AND «*02 

BEQ UPPER 

LDY #*07 

BNE PDEV 

LDY «*00 

LDX #*04 
RTS 



iY IS SEC ADDR 
;X IS DEVICE » 



DUMP SCREEN TO PRINTER 



DPNTR 
ROWS 
COLMNS 
DPFILE 

I 

PDUMP 



*FD 
119 
$28 
$7D 



POINTER 
25 ROWS ON 
40 COLUMNS 
LOGICAL FILE 



CRT 



FF ROLOOP 

CA 
CA 



COLOOP LDA 

SHFTQT 
NOTQT 



JSR PCASE 
LDA «DPFILE 
JSR SETLFS 
LDA #*00 
JSR SETNAM 
JSR OPEN 
BCS DPCLOS 
LDX #DPFILE 
JSR CHKOUT 
LDA #100 
STA DPNTR 
LDA «*04 
STA DPNTR+1 
JSR PCR 
JSR LINE 
JSR LINBLK 
LDX #ROWS 
JSR STOP 
BEQ DPCLOS 
JSR SPC16 
JSR BOXSYM 
JSR PSPACE 
LDY #*00 

(DPNTR) , 
CMP #$22 
BNE SHFTQT 
LDA #127 
CMP #$A2 
BNE NOTQT 
LDA #$A7 
STA PTEMP 



CLOSE ON ERROR 



CAR RET 
SYMBOL LINE 
BLANK LINE 



IF STOP KEY, 



THEN STOP 
MARGIN 
SYMBOL 
SPACE 



PRINT 



Y ;GET CRT CHAR 

IF QUOTE, 

CHANGE TO 

APOSTROPHE 

IF SHIFT QUOTE, 

CHANGE TO 

SHIFT APOSTROPHE 
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NMI Initialization Routine 

As mentioned above, a combination 
RUN/STOP and RESTORE restores the 
peripheral chips, colors, etc. back to 
their default values. This means we 
would lose control of the NMI routine 
because the KERNAL ROM addresses 
are reinstated in the indirect vectors in 
RAM. The new initialization routine 
therefore places our addresses back into 
the vectors for the NMI routine and the 
OUTPUT routine (used in the printer 
utilities]. 

The initialization routine also 
allows us to change the colors to new 
default values, in this case to black 
characters on a grey background. If you 
desire different default colors, change 
them here. 

Lastly, the printer flag is reset to 
disable the printer, if it was on before 
the intialization was run. 

New OUTPUT Routine 

NEWOUT allows you to turn on the 
printer (device #4] so that all output to 
the screen can go to both the screen and 
the printer. When this routine is ac- 
tivated, to get a program listing, just 
type LIST. 

The NEWOUT routine first checks 
to see if the printer flag is off. Then it 
checks to see if the active device is #8. 
Disk access is set up to kill the printer 
output to avoid possible contention prob- 
lems on the serial bus. 

The program then checks to see if 
the screen is in upper/graphics or 
lower/upper case. A file is then opened 
to device #4 with a secondary address 
of or 7, depending on the case. 

The character is sent to the printer, 
the file is closed, then the character is 
sent to the screen. Note that the printer 
file is opened and closed for each 
character. The printer output mode is 
turned on by RESTORE, P, and turned 
off by RESTORE, O, 

Dump Screen to Printer 

In addition to the printer on/off 
functions, a screen dump routine is 
provided. This is accessed by the 
RESTORE key followed by a D. The en- 
tire 40 X 25 screen is copied character 
by character to the printer. The printed 
output is indented to center the text on 
the paper and a dotted outline is drawn 
around the 40 x 25 matrix. As before, 
the printed output is made the same 
case as the screen. 

The PDUMP routine opens and 
26 



CA2? 
CA2A 
CA2C 
CA2E 
CA31 
CA34 
CA.36 
CA39 
CA3C 
CA3E 
CA40 
CA42 
CA44 
CA47 
CA4A 
CA4C 
CA4E 
CA51 
CA52 
CA54 
CA56 
CAS"? 
CASA 
CA5B 
CA5D 
CA5F 
CA61 
CA63 
CA64 
CA66 
CAA9 
CA6C 
CA6F 
CA71 
CA74 



CA75 
CA77 
CA7A 
CA7B 
CA7D 

CA7E 
CA81 
CASS 
CAd6 
CA87 
CA89 
CABB 
CA8D 
CABF 
CA91 
CA93 
CA96 

CA97 
CA9A 
CA9D 
CA9F 
CAA2 
CAA3 
CAA5 
CAAe 
CAAB 
CAAE 



29 80 

8D AF CA 

FO 05 

A9 12 

20 CA Fl 

AD BA C9 

29 3r 

OE BA C9 

2C BA C9 

10 02 

09 eo 

70 02 

09 40 

20 CA Fl 

AD AF CA 

FO 05 

AO 92 

20 CA Fl 
C8 

CO 28 

DO BE 

20 A5 CA 
98 
18 

65 FD 

85 FD 

90 02 

E6 FE 
CA 

CO 9E 

20 97 CA 

20 7E CA 

20 CC FF 

A9 7D 

20 C3 FF 
60 



AO 10 
20 8D CA 
88 

DO FA 
60 

20 75 CA 

AO 2C 

20 91 CA 
88 

DO FA 

A9 OD 

DO 06 

A9 20 

DO 02 

A9 2E 

20 CA Fl 
60 

20 75 CA 
20 91 CA 
AO 29 
20 BD CA 
88 

DO FA 
20 8D CA 
20 91 CA 
20 89 CA 
60 



DECODE 



CHRSNT 



DPCLOS 



AND 
STA 
BEQ 
LDA 
JSR 
LDA 
AND 
ASL 
BIT 
BPL 
ORA 
BV3 
ORA 
JSR 
LDA 
BEQ 
LDA 
JSR 
INY 
CPY 
BNE 
JSR 
TVA 
CLC 
ADC 
STA 
BCC 
INC 
DEX 
BNE 
JSR 
JSR 
JSR 
LDA 
JSR 
RTS 



i$80 

REVFLG 

DECODE 

#$12 

OLDOUT 

PTEMP 

#*3F 

PTEMP 

PTEMP 

» + 4 

#»80 

)n-4 

#*40 

OLDOUT 

REVFLG 

CHRSNT 

#$92 

OLDOUT 

#COLMNS 
COLOOP 
LNEND I 



IF REVERSE CHAR 
THEN SEND REV 
:CODE TO PRINTER 



CHANGE SCREEN 
[CODE TO ASCII 
iCODE FOR 

PRINTER 



CHAR TO PRINTER 
IF REVERSE TURN 
OFF REV MODE 



NEXT COLUMN 



END OF LINE 



DPNTR 

DPNTR 

# + 4 

DPNTR+1 [REVISE POINTER 

ROLOOP 

LINBLK jDONE WITH CRT 

LINE 

CLRCHN jRESET TO CRT 

#DPFILE 

CLOSE 

'(DONE WITH DUMP 



SUBROUTINES TO SUPPORT DUMP 



SPC16 
SP16LP 



LINE 
LINELP 

PCR 

PSPACE 

BOXSYM 
OUTCHR 

i 

LINBLK 

LBLKLP 
LNEND 



LDY #*10 il6 BLANKS 

JSR PSPACE 

DEY 

BNE SP16LP 

RTS 



JSR 
LDY 
JSR 
DEY 
BNE 
LDA 
BNE 
LDA 
BNE 
LDA 
JSR 
RTS 

JSR 
JSR 
LDY 
JSR 
DEY 
BNE 
JSR 
JSR 
JSR 
RTS 



SPC16 

#*2C 

BOXSYM 

LINELP 

#*0D 

OUTCHR 

#*20 

OUTCHR 

#*2E 

OLDOUT 



iLINE OF SYMBOLS 

jCARR RETURN 

jSPACE 

;PERIOD 



SPC16 ; 
BOXSYM 
#*29 
PSPACE 

LBLKLP 
PSPACE 
BOXSYM 
PCR 



BLANK LINE 
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CAAF 00 



CADO 
CAB2 
CAQ4 
CAB6 
CAD9 
CABC 
CABE 
CACO 
CAC2 
CAC4 
CAC6 
CAC8 
CACA 
CACC 
CACD 
CACF 
CAD2 
CADS 
CADS 
CADB 
CADC 
CADE 
CAEl 
CAE2 



CAE4 
CAE7 
CAE9 
CAEC 
CAEE 
CAFl 
CAF.3 
CAF5 
CAFi 
CAF8 
CAFA 
CAFC 
CAFE 
CBOO 
CB02 
C605 
CB07 
CBOA 
CBOD 
CDll 
CB15 
CB19 
CBID 
CB21 
CB25 
CD29 
CB2A 
CB2D 



A2 00 
FO 02 
A2 01 
FE 20 DO 
20 E4 FF 
C9 00 
FO F9 
C9 42 
FO FO 
C9 45 
FO E8 
C9 43 
FO 01 
60 

A2 FA 
FE FF D7 
FE F9 D8 
FE F3 D9 
FE ED DA 
CA 

DO Fl 
EE B6 02 
18 
90 D5 



REVFLG .BYTE *00 jZERO IF NOT REV 



jCHANGE SCR 
)3 ENTRY PO 
iAND CHARAC 
iCHANGED WI 



EDGE 

BACKGD 
CHGCGL 
WAITCL 



CHARAC 
FILLCH 



LDX 
BEQ 
LDX 
INC 
JSR 
CMP 
BEQ 
CMP 
BEQ 
CMP 
BEQ 
CMP 
BEQ 
RTS 
LDX 
INC 
INC 
INC 
INC 
DEX 
BNE 
INC 
CLC 
BCC 



EEN COL 
INTS FO 
TERS--A 
TH ONE 

#*00 

CH6C0L 

#*01 

BRDCLR, 

GET IN 

#*00 

WAITCL 

#$42 

BACKGD 

#*45 

EDGE 

#*43 

CHARAC 

#*FA 

*D7FF,X 

*D8F9,X 

*D9F3,X 

$DAED,X 

FILLCH 
COLOR 

WAITCL 



ORS 

R EDGE, BACKGROUND, 

LL 3 CAN BE 

ENTRY 

jEDGE ENTRY 

jBACKG ENTRY 
X jCHANGE COLOR 
;GET KEY 



jB KEY 

;E KEY 

;C KEY 

jANOTHER KEY 

iCHANGE ALL 
J OF COLOR 
{MEMORY 

;CURSOR COLOR 
.'CONTINUE 



jAPPEND PRO 
iTO TACK ON 
iTO OTHER P 
I 



TXTTAB 
VARTAB 

4C E7 CA APPEND 

A5 2C APPDON 

8D 3F CB 

A5 2B 

8D 40 CB 

A5 2E 

85 2C 

38 

AS 2D 

E9 02 

85 2B 

BO 02 

C6 2C 

A9 2A APON 

8D E5 CA 

A9 CB 

8D Eb CA 

20 41 CB 

OD 4C 4F 41 

44 20 50 47 

4D 32 2C 20 

48 49 54 20 

52 45 53 54 

4F 52 43 2C 

20 41 OD 00 

60 

AD 3F CB APPDGF 

85 2C 



= $2 
» 12 

JMP 
LDA 
STA 
LDA 
STA 
LDA 
STA 



GRAM 

SUBROUTINE PROGRAMS 
ROGRAMS 



APPDON .'MODIFIABLE 

TXTTAB+1 

APHI 

TXTTAB 

APLO 

VARTAB+l 

TXTTAB+1 



JMP 



SEC 

LDA VARTAB 

SBC #$02 

STA TXTTAB 

BCS APON 

DEC TXTTAB+1 

LDA «<APPDOF 

STA APPEND; 1 

LDA «>APPDOF 

STA APPEND+2 

JSR MESSAG 

.BYTE *0D,*4C,*4F,*41 

.BYTE *44,*20,*50,$47 

.BYTE *4D,*32,*2C,*20 

.BYTE *48,*49,*54,*20 

.BYTE *52,*45,*53,*54 

.BYTE *4F,*52,*45,*2C 

.BYTE *20,*41,*0D,*00 

RTS 

LDA APHI 

STA TXTTAB+1 



closes a file similarly to the OUTPUT 
routine. A big difference is the transfor- 
mation from screen code to ASCII code. 
Commodore does some very strange 
things to the printer and screen when a 
reverse character follows a quotation 
mark. It is very difficult to get an exact 
screen dump when this occurs. A 
quotation mark is replaced by an 
apostrophe on printed output, to allow 
reverse characters to be printed (if your 
printer or printer/ interface will handle 
them). Examples of screen dumps are 
shown in Figure 1. In this case the 
printer used (NEC 8023/Tymac Con- 
nection Interface) does not provide 
reverse alphanumerics; a Commodore 
1525 printer would have printed the 
directory header with reverse characters. 

Change Screen Colors 

A routine is provided to change the 
screen colors. This routine has three 
entry points. RESTORE, B changes the 
background color, RESTORE, E 
changes the edge color, and RESTORE, 
C changes the character color. Note 
that all characters on the screen will be 
changed, not just the characters follow- 
ing the cursor. When the colors are 
changed, their code number is in- 
cremented by one, from to 15, back to 
0, etc. 

Once any one color has been changed, 
you can continue to step through the 
colors by repetitively pressing the same 
key (no need to hit RESTORE again). In 
addition, no matter which one you 
started with (B, E, or C), you can 
change the others by pressing the cor- 
responding key. Any other key will get 
you out of the color change mode. 

Append 

To append a program (normally 
consisting of subroutines or DATA 
statements) to another, first load the 
main program in the usual manner: 
LOAD"PRGl",8. Then press 
RESTORE, A This raises the bottom of 
the BASIC program workspace to the 
end of the first program. The computer 
than prompts you to load the second 
program, e.g. LOAD"PRG2",8 and 
press RESTORE, A again. This time the 
bottom of the BASIC workspace is 
moved back down to the previous loca- 
tion. Your two programs are now one, 
which you should SAVE with a new 
name. You can continue to append more 
programs using the same technique. One 
word of caution — make sure that the ap- 
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pended programs have higher line 
numbers than the main programs since 
they are not merged — only appended. 

A general purpose message printer 
routine is used above. To use this 
subroutine in your machine language 
routines, do a JSR to MESSAG followed 
by your message in ASCII characters. 
End the message table with a zero. 
After the message is printed, control 
will return to the next byte following 
the zero. In addition to normal text, 
cursor controls, color changes, etc. can be 
intermixed with text for special effects. 

Entering the Program 

The DOSPLUS routines currently 
start at $C800 and extend through 
$CBFF. Space for more routines is 
available from $C807-C8FF and from 
$CB60-CBBE. Additional extensions 
can be assembled below $C800. The 
DOS WEDGE occupies $CCOO-CFFF, 
so it is advantageous to load and 
initialize the DOS WEDGE and 
DOSPLUS at the same time. 

There are several ways to get the 
program into your Commodore 64. If 
you have an Assembler, type in the 
Assembly code as shown in Listing 1 . A 
compact BASIC loader is also provided; 
see Listing 2. Checksums are used to 
catch your typing errors, which will 
terminate the program. Note the 
change to line #1260 required if you do 
not intend to run the BASIC loader 
with DOS 5.1 in memory. A third 
method is to send the author $10 (US) 
for a disk containing the programs 
shown in Figure 1. (For foreign re- 
quests, please provide sufficient return 
postage). If you load and run the first 
program DOSPLUS, both the DOS- 
WEDGE and the RESTORE routines 
will be loaded and initiated. Then type 
NEW and you're ready to go. 

Seven new functions were added, 
but the tables will allow a total of 32. 
Some possible additional functions in- 
clude variable listing, single step, trace, 
autoline, hex-decimal converter, save 
&. swap screens [for animation), etc. 
Don't hesitate to write if you have a 
useful addition. Or better yet, write it 
up for all MICRO readers. 

/MCftO 

You may contact the author: 

Michael J. Keryan 
713 Locust Drive 
Tallmadge, Ohio 44278 



CB2F 


AD 


40 


CB 




LDA APLO 


CB32 


85 


2B 






STA TXTTAB 


CB34 


A9 


E7 




APOFF 


LDA *<APPDON 


CB36 


eD 


E5 


CA 




STA APPENDtl 


CB39 


A9 


CA 






LDA #>APPDON 


C53EI 


60 


£6 


CA 




STA APPENDf2 


CB3E 


60 








RTS 


CB3F 


FF 






APHI 


.BYTE *FF 


CB40 


FF 






APLO 


.BYTE *FF 



CB41 
CB42 
CB44 
CB45 
CB47 
CD49 
CB4B 
CB4D 
CB4F 
CB51 
CB53 
CBS6 
CB57 
CB59 
CB5B 
CB5C 
CB5E 
CB5F 



C800 
C803 
C806 



CBCO 
CBC4 
CBC8 
CBCC 
CBDO 
CBD4 
CBD8 
CBDC 



CBEO 
C6E4 
CBE8 
CBEC 
CBFO 
CBF4 
CBF8 
CBFC 



68 

85 FB 
68 

85 FC 
A2 00 
E6 FB 
DO 02 
E6 FC 
Al FB 
FO 06 
20 D2 
18 

90 FO 
A5 FC 
48 

A5 FB 
48 
60 



20 47 
20 00 
60 



CBBF 60 



BF E4 
DA BO 
BF BF 
BF BF 
BC BF 
BF BF 
BF BF 
BF BF 



CB CA 

C9 CA 

CB CB 

CB CB 

C9 CB 

CB CB 

CB CB 

CB CB 



FF 



MESSAGE PRINTER 

JSR MESSA6--F0LL0W WITH ASCII 

MESSAGE--END WITH ZERO 



CHROUT 
POINMS 



*FFD2 
*FB 



;SAVE POINTERS 
iFQR RETURN 



iPARSE MESSAGE 



jPRINT IT 
iCONTINUE 



C9 
CC 



MESSAG PLA 

STA POINMS 

PLA 

STA POINMSfl 

LDX #100 

MSSGLP INC POINMS 

ONE #+4 

INC POINMS+1 jBUMP POINTER 

LDA (POINMS, X) |GET CHAR 

BEQ MSS6BK jEND ON ZERO 

JSR CHROUT "" 

CLC 

BCC MSSGLP 

MSS6BK LDA POINMSM 

PHA 

LDA POINMS 

PHA 

RTS 

■ 

# - $C800 
INIDOS « $CCOO 

■ 

BASINT JSR INITNM )INIT NMI UTILS 
JSR INIDOS i INIT DOS WEDGE 
RTS 

# " *CBBF 
RETRN .BYTE *60 



# 

TABL 
B4 CD 
BF BF 
BF BF 
BF C4 
BF BF 
BF BF 
BF BF 
BF BF 



♦ CBCO 



BYTE *BF,*E4,*B4,*CD 
BYTE *DA,$BO,$BF,*BF 
BYTE #DF,*BF,*BF,*BF 
BYTE *BF,*BF,*BF,»C4 
BYTE *BC,*BF,*BF,$BF 
BYTE *BF,*BF,$BF,*BF 
BYTE *BF,$BF,*BF,*BF 
iBYTE $BF,*BF,*BF,*BF 



# 
T^ 
CA CA 
CB CB 
CB CB 
CB C9 
CB CB 
CB CB 
CB CB 
CB CB 



*CBEO 



BH 



BYTE ICB,*CA,*CA,*CA 

BYTE *C9,$CA,*CB,*CB 

BYTE *CB,*C8,$CD,*CB 

BYTE $CB,*CB,$CB,$C9 

BYTE $C9,*CB,$CB,*CB 

BYTE *CB,*CB,*CB,$CB 

BYTE *CB,*CB,$CB,*CB 

BYTE *CB,*CB,ICB,JCB 
END 
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Listing 2 



1 PRINTnCLR] DOSPLUS LOADER" s PRINT" WAIT-~L0ADIN6" 

10 DIM N(l 0)! 1=0 

20 READ A$i I=I+l! CS»0 

30 X*=LEFT*(A*,2) ; 60SUB lOOs IF Z<1 THEN SYS 5120 Os END 

40 DY = Z! KS = Z; X* = MID* (A»,.3, 4) : GOSUB 100; LC«Z 

50 X*=MID*(A*,3,2); GOSUB 1 OOi KS-KS+Zj XI"MID* (A* ,5, 2) ! GOSUB 100: KS=KS+Z 

60 FOR J-HOSY! )(*»MID* ( A* ,5>J »2 ,2): PRINT"."; 

70 GOSUB 100; N(J)=Z; CS»CS+Z; NEXTJ 

80 X$=MID*(AI,7fSY»2,4): GOSUB 100; IF ZOCS+KS THEN PRINT"ERROR LINE i"il; 
STOP 

90 FOR J=1T0BY; POKE LC+J-1,N(J ); NEXTJ ; PRINT"#" ; GOTO 20 

100 J 

110 REM HEX TO DECIMAL 

120 REM X« IS HEX NUMBER TO BE CONVERTED 

130 REM Z IS DECIMAL NUMBER CONVERTED 

140 Z=0 

150 L»LEN(X*)! F0RK=1T0 L 

160 Y=ASC(MID*(X*,K,1)) 

190 Z=Z#16+Y-4e+7#(Y>57) 

200 NEXTK; RETURN 

1000 DATA"18C900488A489848A97F8D0DDDAC0DDD303520BCF620E1FFD00F200C46" 

1010 DATA"18C91815FD20A3FD2018E52047C96C02A05820E4FFC900FOF9291FOC76" 

1020 DATA"18C930AABDC0CB8D3EC9BDE0CB8D3FC920FFFF786848Aa4C72FEA90FE7" 

1030 DATA"18C?48008Dia03A9C98D1903A90C8D20D08D21DOA9008D8602A97lOA74" 

1040 DATA"iaC960aD2603A9C98D2703EAEAEAA9008DBBC96048ADDBC9C904D00E0E" 

1050 DATA"18C9783DA5BAC908F037688DBAC94a8A4a9848A97E20C3FF20CAC90ElB" 

1060 DATA"18C990A97E20BAFFA90020BDFF20C0FFB00BA27E20C9FFADBAC9200EE8" 

1070 DArA"iaC9A8CAFlA97E20C3FF2OCCFF68A868AA684CCAFl0D0OA90485BA0EC2" 

1080 DATA"18C9C08DB8C960A9008DBBC960AD18D02902F004A007D002AOOOA20C9B" 

1090 DATA"18C9D8046020CAC9A9 7D20BAFFA90020BDFF20COFFB07AA27D20C90E65" 

1100 DATA"18C9F0FFA90085FDA90485FE20a9CA207ECA2097CAA21920ElFFF00F32" 

1110 DATA" 13CAO85D2O75CA2O91CA208DCAA00OB1FDC922DOO2A927C9A2DO020CBO" 

U20 DATA"18CA20A9A78DBAC929808DAFCAF005A91220CAF1ADBAC9293FOEBAODFC" 

1130 DATA"18CA38C92CBAC9100209807002094020CAF1ADAFCAF005A99220CA0C03" 

1140 DATA"18CA50FlCaC028DOBE20A5CA981865FD85FD9002E6FECAD09E20970FE9" 

1 150 DATA" iaCA6aCA207ECA20CCFFA97D20C3FF60A01020aDCAa8DOFA6020750E3D" 

1160 DATA"iaCA80CAA02C2091CA8aDOFAA90DD006A920D002A92E20CAF160200DlE" 

1170 DArA"18CA9875CA2091CAA0292O8DCA8aD0FA20aDCA2091CA2O89CA60O00D8B" 

HBO DATA"18CAB0A20OF002A2OlFE2ODO20E4FFC900F0F9C942F0F0C945F0EaiO3D" 

1190 DATA"18CAC8C943FO0160A2FAFEFFD7FEF9D8FEF3D-9FEEDDACAD0FlEEa614D4" 

1200 DATA"iaCAE0021890D54CE7CAA52CaD3FCBA52B8D40CBA52Ea52C3aA52D0C9C" 

1210 DATA"iaCAF8E902852DB002C62CA92A8DE5CAA9CB8DE6CA2041CBOD4C4FODAD" 

1220 DATA" 18CB 104 1442050474D322C2048495420524553544F52452C20410D06BD" 

1230 DATA"18C8280060AD3FCB852CAD40CBa52BA9E7aDE5CAA9CAaDE6CA60FF0F16" 

1240 DATA "iaCB40FF6885FB6885FCA200E6FBD002E6FCAlFBF00620D2FF 1890 1055" 

1250 DATA"0aCB5aF0A5FC4aA5FB4860064C" 

1260 DATA"0 7C8002047C9602000CC034B" 

12 70 DATA" 18CBBF60BFE4B4CDDAB0BFBFBFBFBFBFBFBFBFC4BCBFBFBFBFBFBF 1361" 

1280 DATA "18CDD7BFBFBFBFBFBFBFBFBFCBCACACAC9CACBCBCBCBCBCBCBCBCB 1450" 

1290 DATA"HCBEFC9C9CDCBCBCBCBCBCBCBCBCBCBCBCBCBCB0F42" 

1300 DATA"0O" 

1500 ; 

1510 REM IF DOS WEDGE WILL NOT BE RUN WITH THIS PROGRAM, REPLACE LINE 1260 

WITH; 

1520 REM 1260 DATA" 04C8002047C960025C" 

AMCRO 
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® SANYO MONITOR SALE!! 




9" Data Monitor 



80 Columns x 24 lines 
Green text display 
East to read - no eye strain 
Up front brightness control 
High resolution graphics 
Quick start - no preheating 
Regulated power supply 
Attractive metal cabinet 
UL and FCC approved 



• 75 Day Free Trial - 90 Day Immediate Replacement Warranty 



9" Screen -Green Text Display $ 79.00 

12" Screen -Green Text Display (anti-reflective screen) $ 99.00 
12" Screen - Amber Text Display (anti-reflective screen) $119.00 
1 4" Screen - Color Monitor (national brand) $249.00 

Display Monitors From Sanyo 

With the need for computing power growing every day, Sanyo has 
stepped in to meet the demand with a whole new line of low cost, high 
quality data monitors. Designed for commercial and personal com- 
puter use. All models come with an array of features, including up- 
front brightness and contrast controls. The capacity 5x7 dot 
characters as the input is 24 lines of characters with up to 
80 characters per line. 

Equally important, all are built with Sanyo's commitment 
to technological excellence. In the world of Audio/Video, Sanyo is 
synonymous with reliability and performance. And Sanyo quality is 
reflected in our reputation. Unlike some suppliers, Sanyo designs, 
manufactures and tests virtually all the parts that go into our products, 
from cameras to stereos. That's an assurance not everybody can 
give you! 



Official Video Products 
of the Los Angeles 1984 Olympics 



■wo. » J^-sii , J— 
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• LOWEST PRICES • 15 DAY FREE TRIAL • 90 DAY FREE REPLACEMENT WARRANTY 
• BEST SERVICE IN U.S.A. • ONE DAY EXPRESS MAIL • OVER 500 PROGRAMS • FREE CATALOGS 



I Add $10.00 for shipping, handling and Insurance. Illinois residents f 
I please add 6% tax. Add $20.00 for CANADA, PUERTO RICO, HAWAII | 
j orders-WEDONOTEXPORTTOOTHERCOUNTRIES. j 

I Enclose Cashiers Check, Money Order or Personal Check. Allow 14 | 
I days for delivery, 2 to 7 days for phone orders, 1 day express mail! | 
I Canada orders must be in U.S. dollars. Visa - MasterCard - C.O.D. • 



CK|TCQpD|7CO (WE LOVE OUR CUSTOMERS) 

BOX 550, BARRINGTON, ILLINOIS 60010 
Phon* 312/382-5244 to ordar 




FANTASTIC 

PRINTER 

SALE 



as 

low 

as 



$ 



149 



00 



• 15 Day Free Trial - 180 Day Immediate Replacement Warranty 



80 COLUMN THERMAL PRINTER — 60 CPS 

Bi-directional, dot matrix, prints S'/s" letter size paper, full 80 columns, high 
resolution graphics, dot bit addressable, special symbols and true decenders! 
(Centronics parallel interface) 

80 COLUMN TRACTOR-FRICTION PRINTER — 80 CPS 

Bi-directional, dot matrix, impact, prints single sheets, continuous feed paper, 
adjustable columns, 40 to 132 characters! Roll paper adapter $32,95. (Serial or 
Centronics parallel interface) 

PREMIUM QUALITY 10 " CARRIAGE T/F PRINTER — 120 CPS 

Bi-directional, impact, 9x9 dot matrix with double strike for 18 x 18 dot matrix. 
High resolution bit image (120 x 144 dot matrix) underlining back spacing, left and 
right margin settings, true lower decenders, with super and sub scripts. Prints 
standard, italic, block graphics, special characters, plus 24 of user definable 
characters and much morel! Prints single sheets, continuous feed and roll paper! 
(Centronics parallel interface) 

PREMIUM QUALITY 15% " CARRIAGE PRINTER - 120 CPS 

Has all the features of the Premium Quality 10" Carriage T/F Printer above plus a 

ISVs" carriage and more powerful electronic components to handle large business 

forms! ( Centronics parallel interface) 

HIGH SPEED PREMIUM QUALITY T/F 

10" PRINTER — 160 CPS 

Save printing time with these plus features: 160 CPS speed, 100% duty cycle, 8K 
buffer diverse character fonts special symbols and true decenders, vertical and 
horizontal tabs. This is Red Hot Efficiency!!! (Serial or Centronics parallel interface) 

HIGH SPEED PREMIUM QUALITY 
T/F 1572" PRINTER — 160 CPS 

Has all the features of the 10" Carriage high speed printer plus a IS'A" carriage and 
more powerful electronics to handle larger business forms! (Serial or Centronics 
parallel interface) 

PARALLEL PRINTER INTERFACES: (IN STOCK) 

• For VIC-20 and COMMODORE 64 $49.00 

• For all APPLE COMPUTERS $69.00 

• For ATARI 400 and 800 COMPUTERS $79.00 

NOTE: Other printer interfaces are available at computer stores! 



WE DO NOT EXPORT TO OTHER COUNTRIES EXCEPT 
CANADA. 



LIST 

$199 



$399 



$499 



SALE 

$149 



$209 



$289 



$599 



$699 



$799 



$379 



$499 



$599 



SALE 



SALE 



Enclose Cashiers Check, Money Order or Personal Check. Allow 
14 days for delivery, 2 to 7 days for phone orders, 1 day express 
mail! Canada orders must be in U.S. dollars. We accept Visa 
and MasterCard. We ship COD. 



P^|PmPm|7C§ iWE LOVt our CUSTOMERS) 

BOX 550, BARRINGTON, ILLINOIS 60010 
Phone 312/382-5244 to order 



FLOPPY DISKS SALE *$1.19 ea. 

Economy Model or Cadillac Quality 



LOR>1N 



CERIIflED PERSONAL 
COMPUTER DISK 



yVe have the lowest prices! iORAH 



CERIIHED PERSONA!. 
COMPUTER DISK 



*ECONOMY DISKS 

Good quality 5V4" single sided single density with hub rings. 
Bulk Pac 100 Qty. $1.19 ea. 

lOQty. 1.39 ea. 



Total Price 
Total Price 



$119.00 
13.90 



CADILLAC QUALITY 

• Each disk certified • Free replacement lifetime warranty • Automatic dust remover 

For those who want Cadillac quality we have the Loran Floppy Disk. Used by professionals because they can rely 
on Loran Disks to store important data and programs without fear of toss! Each Loran disk Is 100% certified (an 
exclusive process) plus each disk carries an exclusive FREE REPLACEMENT LIFETIME WARRANTY. With Loran 
disks you can have the peace of mind without the frustration of program loss after hours spent in program 
development. 

100% CERTIFICATION TEST 

Some floppy disk manufacturers only sample test on a batch basis the disks they sell, and then claim they are 
certified. Each Loran disk is individually checked so you will never experience data or program loss during your 
lifetime! 

FREE REPLACEMENT LIFETIME WARRANTY 

We are so sure of Loran Disks that we give you a free replacement warranty against failure to perform due to faul- 
ty materials or workmanship for as long as you own your Loran disk. 

AUTOMATIC DUST REMOVER 

Just like a record needle, disk drive heads must travel hundreds of miles over disk surfaces. Unlike other floppy 
disks the Loran smooth surface finish saves disk drive head wear during the life of the disk. (A rough surface will 
grind your disk drive head like sandpaper). The lint free automatic CLEANING LINER makes sure the disk-killers 
(dust & dirt) are being constantly cleaned while the disk Is being operated. PLUS the Loran Disk has the highest 
probability rate of any other disk in the industry for storing and retaining data without loss for the life of the disk. 

Loran is definitely the Cadiliac disk in the world 

Just to prove it even further, we are offering these super LOW INTRODUCTORY PRICES 
List $4.99 ea. INTRODUCTORY SALE PRICE $2.99 ea. (Box of 10 only) Total price $29.90 

$3.33 ea. (3 quantity) Total price $9.99 

All disks come with hub rings and sleeves in an attractive package. 



DISK DRIVE CLEANER M9.95 



Everyone needs a disk drive doctor 
FACTS 

• 60% of all drive downtime is directly related to poorly maintained drives. 

• Drives should be cleaned each week regardless of use. 

• Drives are sensitive to smoke, dust and all micro particles. 

• Systematic operator performed maintenance is the best way of ensuring error free use of your computer 
system. 

The Cheetah disk drive cleaner can be used with single or double sided S'A" disk drives. The Cheetah is an 
easy to use fast method of maintaining efficient floppy diskette drive operation. 

The Cheetah cleaner comes with 2 disks and is packed in a protective plastic folder to prevent contamination. 
[$29.95/ Sale $19.95 



I Add $10.00 for shipping, handling and Insurance. Illinois residents I 

I please add 6% tax. Add $20.00 for CANADA, PUERTO RICO, HAWAII | 

I orders. WE DO NOT EXPORT TO OTHER COUNTRIES. J 

I Enclose Cashiers Check, Ndoney Oraer or Personal Check. Allow 14 j 

I days for delivery, 2 to 7 days for phone orders, 1 day express mail! ■ 

I Canada orders must be in U.S. dollars. Visa - MasterCard • C.O.D. • 



CMTpDpDI7pQ iWE LOVEOunCUSTOMCRSi 

BOX 550, BARRINGTON, ILLINOIS S0010 
Phone 312/382 5244 to order 
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Sample Commodore Gtaphic Chatactet Set foi the FX80. 
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Normal Characters 



Reversed Characters 



Generating Characters for the 
EPSON FX80 on a Commodore 64 



by Robert M. Tripp 



Basic Piinting Concepts 

The evolution of plain paper printers has been to'ward less 
expensive units that do more. Those who have entered the 
microcomputer revolution lately may not realize that it 
was only five or six years ago that a used Teletype l'™l at 
over $500 was a hot item. And all it could do was produce 
numbers, punctuation and upper case alphabetics - at 10 
character per second with a lot of noise and it was not very 
transportable! Printers have come a long way since then 
and are getting better all the time. One of the most useful 
features to come along recently is the ability for the user to 
define his own character set. Until this capability was 
added, the user had three choices if he needed characters 
that the printer did not support: 

1 . Find some way to live within the constraints of 

the supported character set, such as using [CLR] 
to stand for the inverse heart shape that 
Commodore computers use as the displayable 
representation of the clear screen function. 

2 . Print the character information in a graphics 

mode. 

3 . Purchase a custom printer with the appropriate 

character set - normally limiting the user to the 
printer manufactured by the microcomputer 
company. 
Each alternatives has a major drawback. The first requires 
that special programs be -written to do the conversion from 
the microcomputer display character code to the 
alphanumeric string that will represent it, and results in a 
printout that does not represent the microcomputer 
display very well. The second requires a program to con- 
vert the character oriented information into a graphic 
form, and due to the fact that information has to be 
transmitted for every bit on the line, is quite slow. The 
third is an added expense and may result in a printer with 
limited capabilities and few, if any, of the more 
sophisticated printer features. 

A very neat solution has been provided recently by the 
general purpose printer manufacturers. Many now include 
the ability for the user to define some or all of the 
character set in the printer's RAM. While the number of 
characters that may be so defined, the matrix for 
generating the characters, and the exact protocol for defin- 

No. 68 - January 1984 



ing the characters varies from printer to printer, the basic 
concepts are the same. MICRO, as a microcomputer user, 
probably has more need for the user defineable characters 
than the average user since we deal so often with printed 
material and we deal with such a variety of micro- 
computers. We investigated the available printers and 
selected the Epson FX80 since it has allows all 256 
characters to be user defined. Many of the other printers 
with UDCs currently available only permit a portion of 
the character set to be redefined and some do not support 
copying the existing ROM set into RAM to form the basis 
for the UDC. These two factors may not be significant to 
you, and other printers may be better for your particular 
requirements. Most of the material in this article will be 
applicable to printers in general. 

Custom Character Sets 

The GRAPfflCS issue of MICRO (#66, November 1983) 
discussed character oriented graphic characters and 
provided methods for generating character sets on the 
Commodore 64, VIC 20 and Atari microcomputers. The 
examples used in the articles were, for the most part, 
generated on our FX80. A few of the possible uses for the 
UDC include: 

1 . Graphic characters that replicate those of the 

micro's display. 

2 . Custom graphic characters such as those used for 

line drawings, macro characters, special symbols, 
and so forth. 

3 . Alphabets for foreign languages, computer 

readable codes such as bar codes, optical scanner 
characters, special fonts such as the magnetic ink 
characters found on checks, etc. 

4 . Character segments that may be used to form 

'super sized' printouts for displays such as 
calendars, printed material for the visually 
handicaped, an so on. 



Generation of User Defineable Characters 

The FX80 manual has a very good discussion of the details 
of generating user defineable characters. This presentation 
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1 REM "FXPCG GENERATOR" 


2170 


FOR 1=0 TO 12 




10 PRINT"CGENERATING CHARACTERS" 


2175 


POKE FX+13#CH+I,0:NEXT 




15 CLRrGOSUB 5000: 


2180 


GOSUB 1000:G0T0 2010 




REM GENERATE CHARACTERS 


2200 


REM + SERVICE 




20 GOSUB 5100; REM DEFINE EQUATES 


2205 


IF CP»225 THEN 2400 




30 GOSUB 4000: REM SETUP SCREEN 


2210 


IF X=PD OR X=CX OR X=BX THEN 2280 1 


40 GOSUB 1000: GOTO 2000: REM EDIT 


2220 


IF X=LX OR X=DX THEN 2290 




1000 REM FX CHARACTER DISPLAY 


2240 


X=CX 




1010 BY=FX+13*CH:PRINT"S"i 


2260 


IF Y=LX THEN Y=BX:GOTO 2290 




1020 FOR J=7 TO STEP -1;K=2"J 


2270 


IF Y=DX THEN Y=RX:GOTO 2290 




1030 FOR L=l TO 11 STEP 2:I=BY+L 


2275 


GOTO 2290 




1040 IF PEEK(I) AND K THEN 1100 


2280 


X = CX 




1050 IF PEEK(I-l) AND K THEN 1080 


2290 


H=H+1:G0T0 2500 




1060 IF PEEK(I+1) AND K THEN 1110 


2300 


REM - SERVICE 




1070 PRINT "."j:GOTO 1200 


2310 


IF X=PD OR X=CX OR X=BX THEN 2: 


550 


1080 IF PEEK(I+1) AND K THEN 1120 


2320 


IF X=LX THEN 2290 




1090 PRINT CHR$(LH);:GOTO 1200 


2330 


IF X=DX THEN X=LX:GOTO 2260 




1100 PRINT CHR*(CL);:GOTO 1200 


2340 


X=BX:80T0 2260 




1110 PRINT CHR$(RH);:GOTO 1200 


2350 


X=BX:GOTO 2290 




1120 PRINT CHR*(LR); 


2400 


IF X=PD OR X=BX THEN X=RX:GOTO 


2410 


1200 NEXT 


2402 


IF X=CX OR X=RX THEN X=RX:GOTO 


2410 


1210 PRINT:NEXT 


2404 


IF Y=PD OR Y=BX THEN Y=LX 




1220 RETURN 


2406 


IF Y=CX OR Y=LX THEN Y=LX 




1400 REM OUTPUT FX CHARACTERS TO MEMORY 


2408 


X=DX;GOTO 2290 




1410 BY=FX+13#CH 


2410 


IF Y=LX OR Y=RX THEN Y=DX 




1420 FDR L=0 TO 12: POKE (BY+L) ,0: NEXT 


2415 


IF Y = PD OR Y = BX THEN Y=:LX:GOTO 


2290 


1430 FOR L=l TO 11 STEP 2: I = BY + L : A=0: B = 0: 


2420 


IF Y=CX OR Y=LX THEN Y=LX:GOTO 


2290 


XX=INT(L/2) 


2450 


IF Y=PD OR Y=BX THEN Y=LX:GOTO 


2290 


1440 FOR J=7 TO STEP -1:K=2'J 


2455 


IF Y=LX OR Y=RX THEN Y=DX 




1450 X=PEEK(OG+XX) 


2499 


GOTO 2290 




1460 IF X=CX THEN A=A OR K 


2500 


IF H<0 THEN H=10:V=V-1 




1470 IF X=RX OR X=DX THEN B=B OR K 


2510 


IF H>5 THEN H=0:V=V+1 




1480 XX=XX+RW:NEXT 


2520 


IF V<0 THEN V=5 




1490 POKE(I),A:POKE(I+i) ,B:NEXT 


2530 


IF V>7 THEN V=00 




1500 RETURN 


2540 


POKE P0,X:P0KE(P0+1) ,Y 




2000 REM EDIT 


2550 


GOTO 2020 




2010 H=0:V=0:CP=87 


2600 


REM REVERSE •■ AS BEST YOU CAN 




2015 PRINT"S]]]]]]]]CHAR «";CHj"|| S"; 


2610 


XX = 06 




2020 PO=0G+V«RW+H:X=PEEK(PO) 


2620 


FOR 1=0 TO 7 




2022 Y=PEEK(P0+1):BY=FX+CH#11+V 


2630 


FOR J=0 TO 5:XJ=XX+J 




2025 POKE PO,CP 


2640 


A=PEEK(XJ):IF A=PD THEN A=BX 




2030 GET T$:IF T$="" THEN 2030 


2650 


IF A=BX THEN A=CX;GOTO 2700 




2040 IF Tl="£" THEN CP=225: GOTO 2025 


2660 


IF A=CX OR A=DX THEN A=BX;GOTO 


2700 


2050 IF T*="-" THEN CP=87: GOTO 2025 


2670 


IF A=RX THEN 2720 




2060 IF T*=CL* THEN H=H+1:G0T0 2500 


2675 


IF PR=BX THEN A=CX:GOTO 2700 




2070 IF T$=CR* THEN H=H-1:G0T0 2500 


2680 


IF PEEK(XJ+1)=RX THEN ft=RX: 




2080 IF T$=CD$ THEN V=V+1:G0T0 2500 




GOTO 2700 




2100 IF T*=CU$ THEN V=V-1:G0T0 2500 


2690 


A=BX 




2110 IF T*=RT* THEN H=0: V=V+ 1 ; GOTO 2530 


2700 


PR=A:POKE(XJ) ,A:NEXT 




2115 IF T$ = FU THEN POKE PO,X:GOTO 7000 


2710 


PR=0:XX=XX+RW:NEXT:GOTO 2010 




2120 IF T*=F2* THEN POKE PO,X:GOTO 7100 


2720 


IF PR=DX OR PR=RX THEN A=LX: 




2125 IF T$=F3* THEN POKE P0,X:60T0 7400 




GOTO 2700 




2130 IF T$=F4* THEN POKE PO,X:GOTO 7300 


2730 


A'=BX:GOTO 2700 




2135 IF T*=F5* THEN POKE PO,X:GOTQ 6200 


2800 


IF PR=DX OR PR=RX THEN A=LX: 




2140 IF T*=F6* THEN POKE PO,X:GOTO 6000 




GOTO 2700 




2145 IF T$=F7* THEN POKE PO,X:GOTO 2600 


3000 


PRINT"S"}QS*}LL$i"]"i:INPUT CM 




2150 IF T$=HM$ THEN POKE PO,X:GOTO 2010 


3010 


CH=CHAND255 




2155 IF T*="+" THEN 2200 


3020 


PRINT"S"jQQ*5LLIiS9* 




2160 IF T*="--" THEN 2300 


3030 


RETURN 




2165 IF T*<>CS* THEN 2030 


4000 


PRINT"S"jQQ*; 








"+ ON / - OFF / £ HALF / " FULL" 



34 
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4010 
4020 
4030 
4040 
4050 
4060 
4070 
4080 
5000 
5010 
5020 
5030 
5040 
5045 
5050 
5060 
5065 
5070 
5080 
5090 
5095 
5100 
5110 
5120 
5130 
5140 
5150 
5160 
5165 
5170 
5175 
5130 
5185 
5190 
5195 
5196 
5197 
5198 
6000 
6010 
6020 
6025 
6030 
6040 
6050 
6060 
6070 
6080 
6090 
6100 
6110 
6120 
6125 
6130 
6140 
6200 
6210 
6220 
6225 
6230 



CHAR #" 
CHAR #" 
READ NEXT" 
WRITE CURRENT/READ 
DISK LOAD" 
DISK SAVE" 
REVERSE CHARACTER" 



PRINT"QF1 READ 

PRINT"F2 WRITE 

PRINT"F3 

PRINT"F4 

PRINT"F5 

PRINT"F6 

PRINT"F7 

RETURN 

PRINT CHR$(142) 

POKE 52,48:P0KE 56,48 

POKE 56334, PEEK(56334) 

POKE l,PEEK(n AND 251 

FOR 1=0 TO 2047 

POKE 1 + 12288, PEEK(I+5324B) 

XX = 12288 + 9U8 

FOR 1=0 TO 39 

READ A:POKE(XX+I),A:NEXT 

POKE l,PEEK(n OR 4 

POKE 56334, PEEK(56334) OR 



NEXT' 



AND 254 



iNEXT 



1 



POKE 53272, PEEK(53272) AND 240- OR 12 

RETURN 

POKE 650,128:RT$=CHR*(13) 

0G = 1024:RW='40:FX = 256»56 

POKE 5.3281, IrPOKE 53280,2 

PD=ASC("."):PRINT"2i"; 

BL=123:CL=124:LH=125:LR=126:RH=12y 

BX=91:CX=92:LX=93:DX=94:RX=95 

CH = 0:Fl$="i":F2$ = ".1"!F3* = ";" 

F4$ = "kl":F5* = "||":F6* = "a":F7* = "||" 

cL$="]_":CR*="ir'!cu$="::" 

CD*="Q":HMI="S":CS$="G" 
ZL»=RT$+"::]]] ]]] ]]3]]]]]" 
ZS*=" 
ZR»="IIIIIIIIIIIIIIII||||||||||||||||||" 

EL*=ZL*+ZS*+ZR*;EU*=CU$+EL* 

QQ$=" QQBQQQSQQQ " 

L L * = " ]]]]]]]]]]]]]]]]]] " 

RETURN 

REM SAVE TO DISK 

PRINT" SSQQQOQQQQQQQQQQQQ "i 

B$="":PRINT EL$;:INPUT "FILE";BI 

IF B*="" THEN PRINT CU*;:GOTO 616C 

C$="e0: " + B$-K",S,W" 

OPEN 3,8,8,C* 



#";FC7. 
#":TC7. 



PRINT EU*;: INPUT "FROM CHAR 

PRINT EU*;: INPUT " TO CHAR #";TC 

IF TC7.<FC"/. THEN 6050 

PRINT#3,FC7.;RT$;TCX;RT$i 

FOR I=FC7. TO TC'/. 

PRINT#3,139;RT$;:REM ATTRIBUTE 

II=FX+-I»13 

FOR J = II + 1 TO II + U 

PRINT#3,PEEK(J);RT$;:NEXT J 

NEXTI:CL0SE3 

PRINT EU*;BI;" SAVED"; ;GOTO 2010 

REM LOAD FROM DISK 

PRINT" SQQQQQSQQQQQQQQQQ " ; 

BI="":PRINT EL*;: INPUT "FILE";B$ 

IF B*="" THEN PRINT CU*;:GOT0 632 

C$="«0: "+-B$ + ",S,R" 



6240 
6250 
6260 
6270 
6280 
6285 
6290 
6295 
6300 
6600 
6602 
6604 
6610 
7000 
7010 
7020 
7030 
7100 
7110 
7120 
7130 
7200 
7210 
7220 
7230 
7235 
7240 
7300 
7310 
7400 
7410 
7420 
9000 
9010 
9020 
9030 
9040 



OPEN 3,8,8,C* 

INPUT#3,FC7.,TC7. 

FOR I=FC7. TO TC7. 

II=FX + I»13! INPUT#3,C7.:P0KE 11,0 

FOR J=l TO 11 

INPUT#3,C7.:P0KE 

P0KE(II+12) ,0:N 

CLOSE 3:GQT0 20 

::"5EL*;B* 

RT*; ":;]]] 



PRINT" 

PRINT 

PRINT 

PRINT 

RETURN 

REM READ SPECIF 

PRINT HM*;!GOSU 

IF CC"/.<256 THEN 

CH=CC'/.iGOSUB 10 

REM WRITE SPECI 

PRINT HM$;CD*i! 

IF CC7.<256 THEN 

GOSUB 1400:G0T0 

PRINT QQ*;"Q"; 

PRINT RTI;" ]]]] 

PRINT CH;"|| 

CCy.=CH: INPUT CC 

IF cc7.<o OR ccy. 

RETURN 

REM WRITE CUREN 
GOSUB 1400 
REM READ NEXT 
CH=((CH+1) AND 
GOSUB 1000:G0T0 
DATA 0,0,0,0,0, 
DATA 0,60,126,1 
DATA 0,192,224, 
DATA 0,195,231, 
DATA 0,3,7,7,7, 



(II+J) ,Cy.!NEXT J 

EXT I 

10 

;" LOADED"; :60T0 2010 

]]]]]]]]]!]]]]]] " ; 



lED CHARACTER 
B 7200 

CH=CC-/. 
O0:G0T0 2010 
FIED CHARACTER 
GOSUB 7200 

CH = CC'/. 

2010 

llllUlillll" i 

■ 



)255 THEN CC"/. = 256 
T/READ NEXT 



255) 

2010 
0,0,0 

26,126,126,60,0 
224,224,224,192,0 
231,231,231,195,0 
7,3,0 



is designed to provide you enough information to under- 
stand the operation of the FX80 without the manual, and, 
to provided actual programs that make the whole process 
easier. The FX80 allows the user to define any number of 
characters, up to 256 characters in the standard RAM area, 
more with additional RAM. First consider each character 
in the FX80 to be defined in a matrix that is eight dots high 
by six dots wide. This is similar to the character definition 
on the various microcomputers, although many of them 
are defined as eight by eight. The capital letter A would be 
defined as: 

• 



• • • 



The alphanumerics and punctuation will normally be a 
five by seven character within the six by eight matrix, 
providing at least one blank column and one blank row 
between individual characters. Simple enough. But, the 
FX80 people decided to get even better looking characters 
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by allowing dots to be placed half way between the six col- 
umns. This means that there are not six but eleven poss- 
ible horizontal positions for dots. The capital letter A 
could be defined as: 









Note that the dots in the top half of the letter A overlap 
vertically. The dots on the top line and third line are offset 
one-half space from the dots on the second and fourth 
through seventh lines. This extra resolution in the 
horizontal direction, eleven positions in the normal space 
of six, provides very nice looking character, but does 
severely complicate the character generation process. 
There is an important restriction to be aware of. The dots 
must not overlap. If there is a dot on one of the eleven 
positions, then there may not be a dot on the next 
position. 

The FX80 manual discusses how to define your 
character on graph paper, and then to manually convert 
each of the eleven columns into an 8-bit byte. The top 
most row is considered to have a value of 128 decimal or 
80 hex. The next row is 64 decimal, 40 hex, and so forth. 
The value of each dot that is to be printed in any column is 
summed with all other dot values in the column to pro- 
duce the column value. There is one 8-bit value for each 
column, and eleven columns. In addition to these eleven 
bytes of information to define each character, you must 



SOPHISTICATED TELE-COMMUNICATION IS HERE 

THE COMMUNICATOR 

for 4.0 Commodore Computers 

JIM STRASMA'S REVIEW: 
"THE BEST TERMINAL PACKAGE I'VE SEEN YET" 

By April 1 (maybe sooner) It Will Be Even Better 

SPEEDS UP TO 9600 BAUD 

XON — XOFF 

TRUE CTRL KEY (we do our own keyboard scan) 

THE HARDWARE — A printed circuit board; easily installed in the C8M. It uses 
no C8M connectors; gives a serial poit with true RS232C standard. 

THE SOFTWARE — 

— Emulates the AOOS Regent 100, AOM 31 and/or the 

TeleVideo 950. 1 Or choose the VT1 00 model for use with OEC and VAX 
computers. 

— Runs coresident with BASIC programs; lets BASIC 

programs and program on host computer communicate to develop real- 
ly sophisticated communication and control capatalrties. 

— The program is on ROM at either address; no disk loading 

required. Uses only S1Z bytes of RAM; win rekxals itself around any other 
machine language program at top of memory. 

— Will upload and download and run BASIC programs. With BASIC 

program wil upkud and downk)ad standard data files. 100 page manual 
gives program listing fof BASIC programs. 
Excellent text editor designed to work with THE COMMUNICATOR 

THE COMMUNICATOR $200 
Text tditor $40 

1200 baud modems beginning at low, k)w $385. and even less when purchased 
with THE COMMUNICATOR 

AMPUFY, INC. 
2325 MacbrkJe, Iowa City, Iowa 52240 319-337-8378 

1 trademarks Adds Regent, Inc., Lear Liegler, Inc., Televideo Systems, Inc. 



provide an attribute byte. The attribute byte determines if 
the character is to be shifted down one dot position to pro- 
vide a lower case descender, which column the character 
starts in and which column it ends in. This is provided to 
permit proportional spacing. In this article, we assume 
that all characters are full width and print in the upper 
eight dot positions. 

If you sit down and start plotting out characters on 
graph paper, then assigning each dot its value, summing 
the individual dot values, and so forth, that it is a 
somewhat tedious, repetitive job. The type of job that 
computers are supposed to be good at! So, why not have 
the computer do the work! The FX80 GENERATOR is 
given in Listing 1. It is based on the interactive Program- 
mable Character Generator by Loren Wright that appeared 
in the GRAPHICS issue. Several important additions have 
been made by me. First, the program automatically defines 
a few new characters for use on the Commodore 64. The 
FX80 can printed dots between the main columns of each 
character; the Commodore can not. To make a realistic 
display of the character being generated, three new 
characters are defined. They are the left half of a dot, the 
right half of a dot, and the left and right halves joined 
'back-to-back'. This permits a dot to be generated that 
appears to be half way between the normal columns of the 
Commodore display. Other enhancements include Save to 
Disk, Load from Disk, and Reverse Character. 

The operation of the program is quite straight-forward. 
After the three special half dots are generated, the display 
is initialized. A character is generated in the upper left 
corner of the display. The -i- key is used to write a dot; the 
- key to erase a dot; the up arrow to select the main 
columns; and, the British pound sign to select the dots on 
the intermediate columns. The HOME, CLR and the 
cursor controls can be used for their normal functions. 
Function Keys I through 7 each have a specific function 
associated with them. These functions are listed on the 
display. 

Fl READ CHAR # converts eleven bytes of data in 
memory accessable by the character number into a dot 
display in the upper left comer. 

F2 WRITE CHAR # converts the dot pattern in the 
working space into eleven bytes of data in memory 
accessable by the character F3 READ NEXT reads 
the next character without requiring a number to be 
specified. 

F4 WRITE CURRENT/READ NEXT combines a 
write with a read to make entering of a number of 
consecutive characters more automatic. 
F4 DISK LOAD loads a file specified by name from 
the disk to make it available for editing. 
F6 DISK SAVE saves the character information that 
is in memory on the disk. 

F7 REVERSE CHARACTER changes the dots on the 
main columns to blanks and the blanks to dots. Note that 
this will only work well with patterns that have no dots 
between the main columns. This is because the while the 
FX80 can print half spaces, it can not print half dots. 
Think about it. It is not as simple as it seems. 
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Program Description 

The subroutine at 5000 copies the standard ROM character 
set into RAM. Five new characters are defined by reading 
the DATA statements at 9000 and poking them into the 
character RAM. These five characters are a blank, a solid 
dot, the left half of a dot, the left and right halves of a dot 
joined 'back-to-back', and the right half of a dot. They are 
MICRO No. 68 - January 1984 



used to provided the intermediate dots for the even col- 
umns in the working display. The Character Dot-Data 
Base Address at 53272 is set to point at the RAM character 
set. 

The subroutine at 5100 defines a number of variables 
and strings. 

Subroutine 4000 displays the basic editing screen. 

Subroutine 1000 examines the data in memory for a 
specified FX80 character. Each character is represented by 
13 consecutive memory locations. To make the testing 
easier, the first and last location are always zero. The other 
eleven locations contain the bit pattern for the FX80 eight- 
by-eleven dot matrix. Since the intermediate dots, those 
on the even numbered columns, are generated by a com- 
bination of display patterns - the specially defined patterns 
generated above - the prior, current and next memory loca- 
tions all must be tested to determine the correct pattern to 
display. 

Subroutine 1400 reverses the process and converts the 
display pattern into the correct memory pattern. 

The major editing service starts at 2000. It displays the 
current character number and sets the cursor shape. There 
are two cursor shapes used in this program. The first is an 
open circle that represents the odd columns. It is selected 
by the Vertical Arrow located next to the RESTORE key. 
When it is selected, you can write or erase in the six odd 
columns. The second cursor is a half solid vertical bar that 
represents the even columns. It is selected by the British 
Pound Sign key, and when selected allows you to write or 
erase in the five even columns. Cursor up, down, left and 
right; carriage return, home and clear work area are sup- 
ported. A dot is written by positioning the cursor in the 
desired location, including selecting the correct full or half 
cursor, and pressing the -i- key. A dot is erased by pressing 
the - key. 

The trickiest part of the program is probably in lines 
2200 through 2550 that determine what character(s) 
should be displayed as a function of the current mode - odd 
or even column, the command to write or erase, and the 
information that is currently in the work area. For exam- 
ple, if you are going to write a dot in an even column, you 
must actually write a right half dot in one character posi- 
tion and a left half dot in the next. But what if the next 
position, the odd column, already contains a full dot? Or, 
even more difficult, what if it contains the right half for 



the next even column? A number of tests are made to 
determine how the display must be changed. 

Lines 600 to 2800 are a limited REVERSE function. It is 
easy to reverse a full dot by making it a space, or reverse a 
space by making it a full dot. The problem comes in rever- 
sing a half dot. While the FX80 can print a half space by 
proper positioning of the printing mechanism, it can not 
print a half dot! The print head is only capable of printing a 
full dot. So, it is not possible to accurately reverse patterns 
that contain any half dots. The routine does the best it 
can. When done reversing, it accepts a new character 
number. 

The routine at 6000 to 6140 saves the FX80 character 
information on disk. It is called by the F6 key. It requests a 
filename, the number of the first character to be saved and 
the number of the last character to be saved. It outputs an 
arbitrary attribute byte of 139 which defines each 
character as the upper eight printing positions on the FX80 
with the full character width. The eleven bytes of data that 
define the information for the eleven columns on the FX80 
are then output. 

The routine at 6200 to 6300 loads the FX80 character 
information from the disk. It is called by the F5 key. 

Lines 7000 to 7420 support the other basic editing 
functions that include: Read a specified character. Write a 
specified character, Read the next character, and. Write 
the current character number and Read the next. 

Generating Data Statements 

Now that a new character set for the FX80 has been 
generated using the FX80 Character Generator, and is 
saved on disk as a sequential disk file, the question arises: 
How do I get it over to the FX80? The obvious answer is to 
first convert the sequential file to BASIC DATA 
statements and then add a driver program that would 
output the character information, plus any special 
command information required by the FX80. Step one, 
generating the BASIC DATA statements from the 
sequential file is simply handled by the FXPCG 
DATAMAKER routine. Load and run the FXPCG 
DATAMAKER. It will ask for the FIRST BASIC LINE NO:. 
Input a line number, say 10010. It will then ask for the 
FILENAME:. Input the filename that you used to save the 
character information. The file will be loaded from disk. 



1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 



REM FX 
INPUT 
P0kE52 
OPEN 3 
FOR J 
PRINT 
PRINT 
FOR 1 = 
PRINT 
NEXT J 
NEXT I 
IF OE 
PRINT 
PRINT 
PRINT 
POKE 6 



PCG DATAMAKER - R.M.TRIPP 1983 

"SFIRST BASIC LINE NOs "jLN 

,48;P0KE56,48:C = 256»56!lNPUT "FILENAME! " i B$! C$="eO; " + B* + " , S ,R" 

,8,8,C*!PRINT"LQADING":INPUT»3,F7.,T7.!F0R 1=0 TO T7.-F"/.! X=CH »12 

TO 11:INPUT#3,CX!P0KE(X + J) ,C'/.:NEXT JrNEXT I : E-X + l 1 ! CLOSE 3 

"S";MID*(STR*(LN) ,2); " DATA "; FX ) CHR$ (44) j TXiLN=LN+10: K=l : GOTO 8 

K TO isPRINT MIDI(STR*(LN),2)i" DATA ' 
MID*(STRI(PEEK(C)) , 2) |CHR* (44) j ! C=C + 1 1 
:PRINT CHR$(20)!LN=LN+10 
!PRINT"LN«"jLNj":C="5C5"!E="5E 
THEN PRINT"QQGOTO 14":G0T0 U 
"QQGOTO 7"! GOTO 16 

F0RI=1T08:PRINT I:NEXT:PRINT 

F0RI=9T016:PRINT hNEXT 
31,19!F0R 1 = 1 TO 9:P0KE 631 + 1 , 13: NEXT: POKE 198,10:END 



I ""ri , 



i!FOR J=0 TO 11 
IF OE THEN PRINT 



"GOTO 15"!G0T0 16 



256);I=6:J"11 
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You will then see DATA statements appear on the display, 
the display be cleared, and more DATA statements 
appearing, until all of the characters have been converted 
to DATA statements. Then the numbers 1 to 16 will 
appear on the screen. At this point, the program is erasing 
itself! You are left with a BASIC program that is nothing 
but DATA statement containing your character set. 

Now all that is left is to add a short BASIC program in 
front of these DATA statements that will send 
initialization information to the FX80. The Chaiactei Set 
for FX80 shows the additional DATA that is needed to set 
up a typical FX80 application. Lines 10001 to 10009 are 
the sequences that must be sent to the FX80 to perform the 
specified operations. See the FX80 manual for additional 
details. 

All that you need to add is a driver program that will 
open up your communication channel, read and output 
the information contained in the DATA statements, and 
you are on your way. The FX80 will now contain the 
characters you defined. 

Using the New Chaiacteis 

You will need to write a short conversion program to 
output the correct codes to the FX80 to access the 
characters you have generated. The SCREEN DUMP 
program is an example that was used with my character 
set. It can be appended to an existing screen editing 
program by listing it on the display, loading you editor, 
and then pressing returns on each line of the display. Then 
add a command to your editor to go to the 30000 
subroutine, and you can dump your screen directly to the 



30000 REM SCREEN DUMP 

30001 OPEN 3,4 

30002 FOR Y=0 TO 24 

30003 FOR X=0 TO 39 

30004 A=PEEK(1024+Y«40+X) 

30005 IF A<32 THEN A-A+64:D0T0 30010 

30006 IF A>63 AND A<128 THEN A=A+64! 
GOTO 30010 

30007 IF A>127 AND A<192 THEN A«A-12ei 
GOTO 30010 

30010 PRINT#3,CHARI(A) 

30011 NEXT;PRINT#3,CHR*(13) 

30012 NEXT!PRINT#3,CHR*(13) 

30013 CLOSE 3:RETURN 



FX80. Your conversions will vary as a function of how you 
have defined the special characters on the FX80. 

What's Next 

A scheme to intercept the output of a BASIC LIST 
command and convert it will be presented next month. A 
complete PARALLEL driver will be described that includes 
the cabling information and software to permit you to use 
the FX80 with your Commodore without requiring a serial 
interface! This can save you quite a bit of money since the 
serial interface on the FX80 is an option, the parallel 
interface is standard. While it does take a bit of effort to get 
the FX80 working with the special characters for your 
computer, it does provide you with a virtually unlimited 
printing capability. JUCRO~ 



HOW MUCH LONGER WILL YOU LAST? 



How long can you endure? When will it end?... We're not talking about a new shoot 'em up game for the 
Commodore 64, but Commodore's own disk operating system! Commodore made a great computer in 
the 64 but left its disk operating system out in the cold. If you've been waiting for a true disk operating 
system, here it is!... If you've been waiting for a great BASIC language enhancement that will let you 
utilize the Commodore's many special features, here it is! What is it? It's grafDOS, the great new utility 
from Xylex Software that allows the user to actually become friendly with the Commodore 64! grafDOS 
includes commands like DELETE, RENAME, CATALOG, RUN, etc. The BASIC allows you to do high 
resolution and low resolution graphics, sound, sprite program, plus much, much more for a total of 40 
commands! Plus included in every package is MINIMON, a powerful machine language monitor that 
includes another 20 commands for use in machine language. The disk also comes with sample pro- 
grams and demos including a great music generator! And all this together is only $49.95! How could 
you have lasted this long without it? 

DON'T WAIT ANY LONGER! 
Make your programming easier! grafDOS is available now at your local dealer or: 




INT€R€STING SOFTUiflRC 

21101 S. Harvard Blvd. 
Torrance, CA 90501 
(213) 328-9422 



Visa/MC/Check/Money Order 
Add $2.00 shipping 
CA residents add eVitt sales tax. 
Dealer inquiries invited. 
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Commodore Reviews 



Product Name: 
Equip, req'd: 
Price: 
Manufacturer: 



U.S. Distributors: 



Interpod 

Commodore VIC or 64 

$150.00 

Oxford Computer Systems Ltd. 

Kensington Road, Woodstock 

Oxford OX7 IJR England 

SJB Distributors 
10520 Piano Rd., #110 
Dallas, TX 75238 
(214) 343-1328 

Limbic Systems 
1056 Elwell Ct. 
Palo Alto, CA 94303 
(415) 964-8788 



Product Name: 
Equip, req'd: 

Price: 
Manufacturer: 



DIARY 64 

Commodore 64 Computer, 1541 Disk 

drive or Dattasette; Printer Optional 

$39.95 

Computer Marketing Services 

300 W. Marlton Pike 

Cherry Hill, NJ 08002 

(609) 795-9480 



Description: DIARY 64 is a cartridge based file manage- 
ment program. Files are set up in blocks which may con- 
sist of up to 10 lines of 27 characters each. When the files 
are printed out, only the first four lines of each block is 
printed. This allows printing names and addresses or like 
information. The files may be saved on either tape or disk. 



Description: This is an IEEE-488 and RS-232 interface for 
the VIC-20 and C64. It is guaranteed compatible with all 
programs. Though it lacks the BASIC 4 and monitor of 
RTC's C64-LINK, INTERPOD is a most important new 
product. Highly recommended. 

Pluses: Unlike other IEEE interfaces we've tested, it con- 
nects to the serial bus, like Commodore accessories. Thus, 
there is no need to relocate it and no problem with pro- 
grams that use up internal memory. It easily links a 
VIC-20 or C64 to a whole network of PET/CBM or other 
IEEE-488 devices plus an RS-232 printer, and it works fine 
with most DOS-protected programs. When the computer 
addresses a device, INTERPOD sees if a device on the 
serial bus answers. If not, the call is transferred to the IEEE 
bus to see if any device answers there. If not, and the 
device number is 4, it tries the RS-232 port. It ignores the 
IEEE device when a serial device is on and can arrange 
another address for the RS-232 device. 

Minuses: INTERPOD goes off and sulks if you turn the 
computer off and on without also turning off INTERPOD. 
A multi-plug switch solves this. When rechecking IEEE 
disk status, INTERPOD adds garbage after the valid infor- 
mation; this hangs some data-handling programs. The 
cure, says the fairly adequate manual, is to send a "clear" 
command to INTERPOD' s command channel before each 
new access — easy in your own programs, but impossible 
in protected commerical ones. 



Pluses: The program is quite easy to use. The manual ex- 
plains the functions quite well. Files may be set up using a 
date rather than a block number and the file information 
can be accessed by data as you would use a diary. This 
seems to be the origin of the program's name. Blocks may 
be added, changed or deleted as necessary. There is a 
search function allowing a particular record to be found by 
block number, data, or "key" character. 



Minuses: The blocks cannot be sorted nor can you set up 
and print out all files at one time. Each file record requires 
the user to press the ' 'up-arrow' and the return keys to ob- 
tain a print out. 



Documentation: The eight page manual contains all the 
information needed to use the program effectively. It is 
clearly written and easy to understand. 



Skill level required: Beginning level user. 



Reviewer: Richard E. Devore 



Skill level required: None to use the IEEE port. The usual 
high skill is needed to set up the RS-232 port. 

Reviewer: Jim Strasma 
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Commodore to 
Smart Modem 



by John Kelty 



Adapted for Commodore by Phil Daley 



10 REM 

20 REM 

30 REM 

40 REM 

50 REM 

60 REM 

70 REM 

80 REM 

90 REM 

100 REM 

110 REM 

120 REM 

130 REM 

140 REM 

150 REM 

155 REM 

160 REM 

170 REM 

180 REM 

190 REM 

200 REM 

205 REM 

210 REM 

215 REM 

220 REM 

230 REM 

240 REM 

250 REM 



SMART300 

WRITTEN BY JOHN R. KELTY 
LINCOLN, NEBRASKA 68505 
MODIFIED FOR C64 BY PHIL DALEY 

USE THIS PROGRAM TO CONNECT 
AND PROGRAM THE HAYES 
SMARTMODEM TO THE 
COMMODORE-64 COMPUTER. 

THE CONNECTOR CABLE SHOULD 
CONNECT TO THE RS-232 PORT 
IN THE FOLLOWIMG MAY: 
HAYES PIN C--64 PIN 



1 
2 
3 
5 
6 
7 

a 

20 
22 



A 

M 

B i. 

K 

L 

N 

H 

E 

F 



THE 300 BAUD HAYES MODEM 
MAY BE USED WITH VIDEOTEX 
OR ANY OTHER TERMINAL 
PACKAGE THAT ALLOWS THE 



THE HAYES WILL CPERAT 
LOCALLY AT HIGHER RAT 
BUT NO HIGHER THAN 30 
WHILE ON LINE. 

SEE YOUR USER'S MANUA 
FROM HAYES FOR DETAIL 



E 

ES 





L 
S. 



*************************** 

THING 



10DEM 



BY: KELTY ENGINEERING" 



260 REM HAYES TO RUN AT 300 BAUD. 

270 REM 

280 REM 

290 REM 

300 REM 

310 REM 

320 REM 

330 REM 

340 REM 

350 REM 

360 REM 

370 REM 

380 REM OPEN MODEM LINE FIRST 

390 OPEN 2,2,3,CHR*(6) 

420 DIM M$(5) ,SN*(9) 

430 REM »»»»»»#»#♦♦#»»»##»»»#( 

510 PRINT"2e ***** SMART M( 

«###♦" 
520 PRINT" 
530 PRINT" 

540 PRINT: 

PRINT"CONNECT CABLES TO MODEM," 
545 PRINT"COMPUTER AND PHONE 

COMPANY." 
550 PRINTiPRINT: 

PRINT"(BREAK AND LIST THIS 

PROGRAM TO" 

PRINT"SEE CABLE DETAILS). " 

PRINTiPRINT: 

INPUT"PRESS ENTER WHEN READY"|A$ 

PRINr'CQ" 
580 PRINT#2,"AT Z"i 'CLEAR MODE 
590 REM ♦»#»#»»»»»#*##»##»»##( 

REM MENU 

M*(1)'="AUT0 DIALING" 

M$(2)="AUT0 ANSWERING" 

FOR S^l TO 2 

PRINTSjMKS) 

NEXT S 

PRINT:PRINTi 

PRINT"SELECT ONE OF THE ABOVE" 

GET AlilF A$=""THEN670 

ON VAL(A$) GOSUB 700,1310 

GOTO 510 

REM ****** ***************\ 

REM AUTO DIALING ROUTINE 

REM *********************i 

REM 

PRINT"GG"M$(1) 

PRINTiPRINT: 

PRINT"! DIAL A 

PRINT"2 DIAL A 

GET A*iIFA$=""THEN770 

ONVAL(A$) GOT0800,980 

60T0740 

REM #»##»*#####*###«#»###i 

HH-2! 'HOW MANY NUMBERS 

REM TO CHANGE THIS LIST, 

MAKE HM=HOW 

REM MANY # YOU WANT TO LIST (MAX 

OF 9). 



555 
560 

570 



600 
610 
620 
630 
640 
650 
660 

670 
680 
690 
700 
710 
720 
730 
740 
750 

760 
770 
780 
790 
800 
810 
820 

825 



)EM 



SAVED NUMB 
NEW NUMBER 



i****** 
i****** 

ER" 



[** 



40 
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830 REM THEN INSERT LINES SIMILAR TO 

THOSE 
835 REM BELOW WITH YOUR NUMBERS AND 

NAMES. 
840 PRINT"CiNUMBERS YOU CAN EASILY 

CALL"!PRINT 
850 SN*(1) 

="1 XXX-XXXX A FRIEND 



860 SN$(2) 

= " 2 X X X - X X X • 



8 70 
880 
890 
900 

910 

920 
930 
940 
950 
960 
970 
980 
990 
1000 



1005 
1010 
1020 

1030 

1040 

1050 
1060 
1070 

loao 

1090 
1100 
1110 
1120 
1160 
1170 
1180 
1190 
1200 
1220 
1230 

1240 

1250 

1300 
1310 
1320 
1330 



XXXX 



A BBS 



OF THE ABOVE" 
LIST TO EDIT 



FOR K=l TO HM 

PRINT SN»(K) 

NEXT 

PRINT! 

PRINT"SELECT ONE 

PRINT" (BREAK AND 

THESE NUMBERS)." 

GET A»! IF A$»""THEN920 

NB=VAL(A$) 

IF(NB<1)0R(NB>HM)THEN 800 

P$=MID$(SN»(NB) ,5,16) 

G0SUB1090 

RETURN 

REM #»####»#»#########»####### 

PRINT:PRINT"DIALING A NEW NUMBER" 

PRINT; 

PRINT"TYPE IN THE PHONE NUMBER 

THAT" 

PRINT"YOU WISH TO CALL. " 

PRINT"EXAMPLES!" 

PRINT"l-aOO-XXX-XXXX 

DISTANCE 

PRINT"112-800-XXX-XXXX 

LINCOLN 

PRINT"XXX-XXXX 

CALL 

PRINT 

INPUT' 

GOSUB 

RETURN 

REM ************************** 

REM NUMBER KNOWN AT THIS POINT 

REM READY TO DIAL 

PRINT#2,"AT FO D"P» 

REM ************************** 

REM YOU CAN RUN ANY TERMINAL 

PACKAGE THAT YOU WISH BY 

EDITING THE NEXT LINES. 

L0AD"M0DC0MM.PRG",8 

RUN 
PRINT"CQ^Y0U NEED TO USE YOUR 
OWN" 

PRINT"TERMINAL PACKAGE AT THIS 
POINT" 

PRINT"(SUCH AS VIDEOTEX AND 
OTHERS)." 
GOTO 2040 

REM ******************** 
REM AUTO ANSWER ROUTINE 
REM ******************** 



LONG 



FROM 



LOCAL 



'TYPE 
1090 



DESIRED NUMBER"jP$ 



REM 
REM 
REM 
REM 



_ 



1340 
1350 
1360 
1370 
1380 
1390 
1400 
1410 
1420 
1430 
1440 

1450 
1460 
1470 
1480 
1490 
1500 
1510 

1520 



1530 
1540 
1550 
1560 

1570 
1580 
1590 

1600 
1610 

1620 

1630 

1640 
1650 
1660 
1670 

1680 
1690 
1700 
1710 
1720 
1730 
1740 
1750 



1760 

1770 

1780 
1790 

1800 
1810 



REM 

PRINT" 

PRINT 

REM ME 

AN$(1) 

AN$(2) 

AN»(3) 

FOR SA 

PRINTS 

NEXT S 

PRINT! 

PRINT" 

GET A* 

PRINT" 

ON VAL 

GOTO 1 

REM ** 

REM DO 

PRINT! 

PRINT" 

PRINT! 

PRINT" 

FUNCTI 

PRINT" 

PRINT# 

GOTO 2 

REM ** 



C;Q"M$(2) 

NU 

="D0 NOT ANSWER" 
="ANSWER IMMEDIATELY" 
""ANSWER AFTER XX RINGS" 
= 1 TO 3 
A;AN*(SA) 
A 

PRINT! 

SELECT ONE OF THE ABOVE" 
!lF A$='""THEN 1450 
CQ "M»(2) 
(A$) GOSUB 1490,1560,1720 
310 

««««««««««««««««««««««« 
NOT ANSWER 

#»»"AN$(1) "***" 

THE SMART MODEM ANSWER 

ON" 

IS DISABLED." 

2, "AT S0=0" 

040 

*********************** 



REM ANSWER IMMEDIATELY 

PRINT" »»»"AN»(2)"»»»" 

PRINT"THE SMART MODEM WILL 

ANSWER ALL" 

PRINT"CALLS IMMEDIATELY." 

PRINT"USE THIS TO TRANSFER CALLS 

THAT" 

PRINT"ARE ALREADY IN PROGRESS 

BETWEEN" 

PRINT"TWO INDIVIDUALS TO 

COMMUNICATION" 

PRINT"BETWEEN THEIR COMPUTERS." 

GOSUB 1870 

PRINT#2,"AT"DP»"A" 

PRINT"AT THIS POINT YOU NEED TO 

RUN" 

PRINT"OR EXEC YOUR OWN RECEIVER" 

PRINT"PROGRAM TO INTERPRET THE" 

PRINT"INCOMING CALL." 

G0T02040 

REM ******************** 

REM ANSWER AFTER XX RINGS 

PRINTiPRINT" »##"AN*(3)"»»»" 

PRINT! 

PRINT"THE SMART MODEM WILL 

ANSWER ALL" 

PRINT"CALLS AFTER THE NUMBER OF 

RINGS" 

PRINT"YOU SELECT (FROM 1 TO 255 

RINGS)" 

PRINT 

INPUT"HOW MANY RINGS (I TO 255)"; 

RG 

RG=INT(RG) 

IF RG<1 OR RG>255 THEN 1790 
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1820 



1830 
1640 
1850 
1660 
1870 
1880 
1890 



1900 

1910 
1920 
1930 
1940 
1950 
1760 
1970 

1980 
1990 
2000 
2010 

2020 
2030 
2040 
2050 



PRINT: 

PRINT"THE PHONE 
ANSWERED" 
PRINT''AFTER"R6"R 
GOSUe 1870 
PRINT«2,"AT"DP#" 
PRINT.-GOTO 1670 
REM «*«««««««««« 
REM FULL OR HALF 
PRINT! 

PRINT"DO YOU WAN 
DUPLEX?" 

PRINT'MIF YOU DO 
TRY HALF)." 
PRINT;PRINT"1 
PRINT"2 HALF 

GET A$:IF A#=""T 
ON VAL(A*) GOTO 
REM FULL DUPLEX 
DP$."F1" 

PRINT! 

PRINT'TULL DUPLE 

GOTO 2020 

REM HALF DUPLEX 

DP*="FO" 

PRINT! 

PRINT"HALF DUPLE 

PRINT 

RETURN 

REM ############ 

REM EXIT ROUTINE 



WILL BE 

INGS." 

SO""RG 

************* 
DUPLEX 

T FULL OR HALF 

NOT KNOW, 

FULL DUPLEX" 
DUPLEX" 
HEN1930 
1950,1990 

X SELECTED." 



X SELECTED." 



############# 



2080 PRINT! 

PRINT"THIS PROGRAM HAS ENDED." 
3000 REM THIS PROGRAM SENDS AND 

RECEIVES 
3010 REM TRUE ASCII DATA 
3020 DIMF-/.(255) ,T7.(255) 
3200 F0RJ-32T064!T"/.(J)-J:NEXT 
3210 Ty.(13) = 13:TX(20)'=8:RV=l8!CT = 
3220 F0RJ«65T090!K-J + 32!T7.(J)»K!NEXT 
3230 F0RJ=91T095!TX(J)='JiNEXT 
3240 FOR J-193 TO 216: K-J-128: T7. ( J ) -K! 

NEXT 
3250 Ty.(146)»16:TX(l33)»16 
3260 FOR J»0 TO 255 
3270 K«T'/.(J) 

3280 IF KOOTHEN FX (K) =J : F7. (K+128) =J 
3290 NEXT 

3300 PRINT " "CHR*(147) 
3310 GET#2,A* 

3320 IF A$=""OR STOO THEN 3360 
3330 PRINT " "CHR$(157)i 

CHR$(F7.(ASC(A*)))i 
3340 IF F7,(ASC(A*)).=34 THEN P0kE212,0 
3350 fiOTO 3310 
3360 PRINTCHR$(RV)" "CHR*(157)! 

CHR$(146);!6ET A* 
3370 IF A*<>""THEN PRINT#2, 

CHR$(T7.(ASC(A*)))| 

3380 CT«CT+1 

3390 IF CT=8 THEN CT=0! RV= 164-RV 

3400 GOTO 3310 m,/v»«- 

JMCRO 



NOT ONLY ANOTHER TECHNOLOGICAL BREAKTHROUGH 



BUT ALSO EASY TO USE AND TO INSTALL 



Modems are the most important device 
used to Irnk two products together 
through ordinary telephone lines at 
miles apart. The INCOMM STARCOM. a 
300 1200 bps Auto Dial, Auto Answer. 
Auto Log On modem was introduced to 



link two high speed devices together 
With having absolutely NO knowledge 
of computers or communications in 
general. Anybody can install and 
operate the STARCOM Family in a few 



THE 
f STARCOM 

lM50. 



^•+°. 



STARCOM is a 300/1200 bps Auto Dial. Aulo Log On/Aul 
OSCOM is a 300/1200 bps Auto Dial/Auto Log On.Aulo An 
(TM) Computer Software (included) modem. 
COMSOFT IS a communication software package 
OEM (V10DEM BOARD is also available for custom insta 



-'.•'« 






SEND FOR 
FULL LINE 
CATALOG 

of peripherals in- 
cluding Modems. 
Muxes, Switches 
' "Ireaker Boxes 



DEALER INQUIRIES 

INVITED ^ 

(312) 459-8881 
or 1 -800-323-2666 



INCOMM 

115 N. WOLF RD. WHEELING, IL 60090 




THE 
OSCOM 

.^520. 



so COI\/IF>AC-r: 

Only 1'4 X 6I2 X 7'2 1.5 lbs 
Fits in your coat pocket! 
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Commodore Compass 




by Loren Wright 



High Resolution on the 
Commodore 64 

Many C-64 users don't even know that their 
machines have high-resolution graphics, let alone 
know how to use them! There is no mention in 
the User's Guide, and very little in the Programmer's 
Reference Guide. In this column I'll explain a little about 
these modes, and provide a couple machine-language 
utilities to make high-resolution programming easier. 

There are actually two bit-map modes. One is a two- 
color mode (hereafter called hi-res bit-map mode) that pro- 
vides resolution of 320 by 200 pixels. The other is a four- 
color mode (hereafter called multicoloi bit-map mode) 
providing resolution of 160 by 200 pixels. Each mode uses 
an 8K bit-map area and the IK color memory. 

In hi-res bit-map mode, each bit in bit-map memory 
corresponds to a pixel on the screen. If the bit is a 1, then 
the corresponding pixel appears in the foreground color; if 
the bit is a 0, then the corresponding pixel appears in the 
background color. Screen memory is used to select the 
foreground and background colors for each 8-pixel by 
8-pixel area (the area normally occupied by a character). 
Bit-map memory is arranged to take advantage of this 
square-by-square color selection capability. The first eight 
bytes in bit-map memory represent the pixels of an 8-by-8 
square at the top left comer. The next eight bytes of repre- 
sent the 8-by-8 square immediately to the right of that. 
This arrangement makes it a little more difficult to 
calculate a given bit, but the reward is being able to use 
many more than two colors on a high-resolution screen. 
In multicolor bit-map mode, the pixels are twice as 
wide and it takes two bits to specify the source of the color 
00 — background #0, 01 — high four bits of screen 
memory location, 10 — low four bits of screen memory 
location, 11 — color memory location. Each byte contains 
four bit-pairs, each of which corresponds to a double- 
width pixel. The bytes are arranged in the same way as in 
hi-res bit-map mode, and the little squares are the same 
size (8 rows of 4 double- width pixels). Each little square 
may have only four colors in it, but there may be many 
more than four colors on the whole screen at once. 

Listing 1 is a hi-res bit-map routine to calculate the 
proper byte BY, byte contents BQ, and bit BI, as well as 
the proper position PO for control of colors. X and Y are 
the input and represent the x- and y-coordinates of the hi- 
res pixel. 0,0 is the coordinate of the upper-left comer. BA 
is the starting address of bit-map memory, and OG is the 
screen memory start address. These vary with the memory 
configuration you choose. 
No. 68 - January 1984 



Listing 2 is a similar routine, only for multicolor bit- 
map mode. X and Y are the input. Remember X ranges 
from to 159 because of the double-width pixels. The out- 
put is the byte BY, byte contents BQ, bit pair BP, and posi- 
tion PO. 

To use listing 1, perform the following set-up once at 
the beginning of your program: 

40 DIM P%(7),M%(7):FORI = QT07: P%(I)=:2AI: 
M%=255-P%(l): NEXTI 

The following calling sequence may now be used: 

1 1 0GOSLIB 4000: REM X = TO 31 9, Y = TO 1 99 
120POKE BY.BQ AND M%(BI) OR P%(BI) 

To use listing 2, perform the following set-up once at the 
beginning of your program: 

40 DIM P%(3),M%(3):FORI = 0TO3: P%(I) = 4AI: 
M%=255-P%(I):NEXTI 

You may now use the following calling sequence: 

110GOSUB4000: REMX = 0TO 159, Y = 0TO 199 
120POKE BY.BQ AND M%(BP) OR P%(BP) 



How to Set Up Bit Map Modes 

The procedure shown in the Programmer's Reference 
Guide uses bit-map memory at $2000 (8192). This is ade- 
quate for experimenting with short programs, but the 6K 
left for BASIC is not adequate for a program of any 
significance. Listing 3 is a routine to set up bit-map 
memory at $6000 (24576). This uses bank 1 for the VIC II, 
so the screen must be moved to $5C00 (23552). The result 
is over 20K for your BASIC program. Listing 4 is a routine 
to restore the multicolor bit-map mode. Listing 5 is a rou- 
tine to restore the normal screen. If you are using either 
listing 3 or listing 4, the first lines of your program must be: 

10 POKE 52,92: POKE 56,92: POKE 55,0: CLR 
20 BA = 24576: 00 = 23552: MY=199: MX = 319; 
REM MX =159 for multicolor 

Line 10 prevents the BASIC program from writing over 

bit-map or screen memory. It must be the very first line in 

your program. Because the CLR instruction clears the 

stack, as well as the variables, this statement cannot be in- 
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eluded in a subroutine. Line 20 sets up constants used in 
the subroutines of listings 1 and 2. 

Machine-Language Bit-Map Utilities 

Listing 6 contains a group of machine-language 
utilities in the form of BASIC DATA statements. Space 
does not permit listing it in source format. Also included 
in the listing is a routine to POKE the utilities into the 
cassette buffer and subroutines to call each routine. 

Important note: The routines must be POKEd back 
into the cassette buffer after using either the cassette or 
disk or LOAD or SAVE operations. 



Set-up for routines: 




POKE 842,92 


High byte of the beginning 




of screen memory. 


POKE 843,96 


High byte of the beginning 




of bit-map memory. 


Clear bit map: 




POKE840,CC 


CC is used to fill bit-map 




memory, clears to bacl<- 




ground color. 


SYS 845 




Clear color memory: 




POKE840,C 


is color to fill color 




memory. 


SYS 883 


Execute routine. 


Clear Multicolor Color 1 




or Hi-res Foreground 




POKE 840,0 


Color used to fill high 4 bits 




of screen memory without 




disturbing low 4 bits. 


SYS 898 


Execute routine. 


Clear Multicolor Color 2 




or Hi-res Background 




POKE840,C 


Color used to fill low 4 bits 




of screen memory without 




disturbing high 4 bits. 


SYS 915 


Execute routine. 



Miscellaneous Tidbits 

If your program should happen to stop while in one of 
the bit-map modes, it may appear that you have lost con- 
trol of your computer. One way to get out is to press STOP 
and RESTORE together. Another is to type GOSUB 8100 
and press RETURN. Even though you can't see any 
characters on the screen, the command will be accepted. 
Keep in mind that there is only one location for color 
memory and it applies to whatever screen is in use at the 
moment. Therefore, if you are in multicolor bit-map mode 
and you switch to a normal character screen, then any col- 
or changes you make here will also affect Color 3 on the 
bit-map screen. One way to avoid this is to keep Color 3 
the same for the entire screen. Another is to copy color 
memory to a IK buffer at $5800. This area must be pro- 
tected hrom BASIC by POKEing 88 instead of 92 in line 10. 
When you return to the bit-map screen, copy the contents 
of the buffer back into color memory. 

Terry Peterson's BSAVE procedure (September '83 



MICRO) may be used to SAVE bit-map and screen memory 
to tape or disk. To load, LOAD"name", dv,l, where dv is 
the device number. To SAVE color memory to tape, you 
must first copy it to a location below $8000 (32768), such 
as a buffer at $5800. 

Finally, SAVE your program often. There is a lot to 
keep track of, and therefore a lot that can go wrong. 

AMCfX) 



List 1: Calculate byte and bit In hl-res bit-map mode. 

4000 REM CRLCULRTE BVTE & 
40 1 Rt-4= I NT ■:: 'r'/S > : C0--= I NT <. X,- 

VflND? : BT=7- •:: XRND7 ::• 
4020 Pi:i=40*RW+CO 
40:30 B't'=BR+RW*:320+C:O*8-^LN 
4040 eQ=PEEK'::BV> 
4050 RETURN 



P I KEL. 
•3:> :LN= 



List 2: Calculate byte and bit pair in 


multi-color bit-map mode. 1 


4000 


REM CRLCULRTE 


NEW pi:: 


<:el 


DRTR 


4010 


RW= 


= INT';V/8;:' ! 1 


::o=iNT'::;- 


•:,-'4 


■ 


4020 


LH= 


=VRHD7: EP=- 


3-'::XRND:: 


3.:' 




4030 


BV= 


=BR+RW*320-i-i 


::0*S-^LN 






4040 


BQ= 


=PEEK';eV.-.' 








4050 


Pi:i= 


=40*RW-^CU 








4060 


RETURN 









List 3: Set up hl-res bit-map 


mode. 








8000 REM SET UP 


HI -RES 


IN 


BRNK 


1 


8001 REM HI -RES 


SCREEN 


*6 


000 - 1- ■ 


T-FF 


8002 REM SCREEN 


MEMORV 


*5 


C00-*5FFF 1 


8003 REM MCM OFP & HI- 


RES 


ON 




8010 POKE 56578 


r PEEK-:: 5 


657 


8::'0R3 




8020 POKE 56576 


r PEEK":: 5 


657 


6::'RNDc 


152UR2 


8030 POKE 53272 


.PEEK-:: 5 


327 


2>RNDT 


"OR 120 


3040 POKE 53265 


.PEEK<5 


326 


5>0R3c 


j 


8060 RETURN 











List 4: Set up multi-color bit 


-map mode. 








8000 REM SET UP 


HI -RES 


IN 


BRNK 


1 


8001 REM HI -RES 


SCREEN 


*6 


000-* 7 


FFF 


8002 REM SCREEN 


MEMORV 


*5 


C00~*5 


FFF 


8003 REM MCM .fc HI -RES 


UN 






8010 POKE 56578 


.PEEK-:; 5 


657 


S::>0R3 




8020 POKE 56576 


.PEEK'-.: 5 


657 


6::'RHD2 


5 2 OR 2 


S030 POKE 53272 


.PEEK-:: 5 


32? 


2>RMD? 


OR 1 2ti 


8040 POKE 53265 


,PEEK<5 


326 


5::'0R32 




8050 POKE 53270 


^ PEEK-:: 5 


327 


0::'ORie 




8060 RETURN 











44 



MICRO 



No. 68 - January 1984 



List S: Restore normal screen. 

8100 REM RESTORE HORMflL SCREEN 

8110 POKE 56578., PEEK ^SeS/Si-'ORS 

8120 POKE 56576., PEEK'.: 56576 ::'RHD2520R3 

3130 POKE 53272 ., PEEK < 53272 ::'flHD70R 16 

8140 POKE 53265., PEEK < 53265 ::'flND223 

8150 POKE 53270., PEEK':: 53270 >fiHD239 

8160 RETURN 



List 6: Machine-language routines, Installation and calling routines. 

30 GOSUBS500 : P0KE343 ., I NT < BR/256 :> : P0KE842 ., I NT -C OG/256 > 

3 1 00 POKE840 ., C : S VS898 : RETURN : REM CLERR COLOR 1 

3200 POKE340.,C:SVS915:RETURN:REM CLERR COLOR 2 

3300 POKE840,,C:SVS8S3: RETURN: REM CLERR COLOR 3 

8500 REM RERD IN ML ROUTINE 

8510 KX=840:I=0 

8520 RERDVV : IF't"t'=- 1 THEN8540 

8530 pnKE;=-;;-;+ 1 ., VV : I = I + 1 : GOTOS520 

8540 RETURN 

1 9000 DRTR2 ., 240 ., 92 ., 32 ., 95 ., 1 73 ., 75 ,, 3 ., 1 33 ., 254 ., 24 ., 1 05 ., 32 ., 1 4 1 ., 76 ., 3 

1 90 1 DRTR253 ., 1 73 ., 72 ., 3 ., 1 60 ., .,145 ,, 253 ., 200 ., 208 ., 25 1 ., 1 65 ., 254 ., 24 ., 

133 .,254 .,205 
1 9020 DRTR76 ., 3 ., 208 ., 236 ., 96 ., 1 69 ., 2 1 6 ., 1 33 ., 254 ,, 1 69 

76., 3 
1 9030 DRTR20S ., 2 18,1 73 ., 72 ., 3 ., 1 ., 1 ., 1 ., 1 ., 1 4 1 ., 72 
1 9040 DRTR 1 63 ., 240 .,141., 73 ., 3 ., 1 73 ,, 74 ., 3 ., 1 33 ,, 254 ., 24 
1 9050 DRTR253 ., 1 68 .,177 ,, 253 ., 45 ., 73 ., 3 ., 1 3 ., 72 ., 3 ., 1 45 ., 

208 
1 9060 DRTR239 ., 1 65 ., 254 ., 205 .,. 76 ., 3 ., 208 ., 232 ., 240 ., 4 ., 230 ., 254 ., 208 ., 226 



.0,1 33 , 



169. 



,3., 169., 15., 141. ,7 
.,105 ,,3., 141., 76,,:] 
253 ., 200 ., 240 ., 1 3 ., 



., 1 €-3 


,0., 13: 


.105,, 


1 , 


220., 


141., 


3.,3., 


208,5 


!., 169 


.,0,13 


192,, 


232., 



96 .,-1 
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FOR APPLE II PLUS, FRANKLIN, APPLE He 

Font Down Loader 

Expand the capacity of your printer hundreds of times 

Load custom fonts into your Apple® Matrix Printer, ProwriterrM 
8510A, OKI® Microline 92, 93, 84 Step 11, and Epson® FX and use 
them with virtually every word processor to turn your printer into a 
custom typesetter. After the fonts are loaded, they will stay in your 
printer until it's turned off. A font editor is also provided to allow you to 
create your own graphics, text, foreign language letters, math and 
electronics symbols to load into your printer. On-Disk (Specify Printer) 
»39°° 

New vnpioved versions with drivers for Grappler, Pkaso, Wizard and most other intelligent parallel boards. 

$100 REWARD^ micro umrE 

P.O. Box 113 



Submit the best or most unique 
font using the above software and we 
will make you $100 richer. Other 
prizes for the first 25 runners up. 




Pompton Plains, N.J. 
07444 

Dealer and Distributor inquiries Invited 



"There's got lo be a better way to load fonts!' 



CALL (201) 838-9027 
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Atari To 
Smartrnodem 



By John Kelty 

Adapted for Atari by Phil Daley 



This is an adaptation of my pro- 
gram for the Color Computer. 
The hardware requirements are 
the Hayes Smart Modem and the Atari 
850 commmunications interface. This 
program was specifically written with 
the serial line connected to port 1 of the 
serial port (the standard port for com- 
munic^ions). This fantastic modem 
can be programmed from Atari BASIC. 
The interface cable is a standard 
Atari communications cable — 9-pin 
D-connector to DB-25. If you want to 
wire your own cable, here are the 
connections: 



Atari Connector 


DB-25 


1 


20 


2 


8 


3 


2 


4 


■3 


5 


7 


6 


6 


7 


4 


8 


5 


9 


11 



You need 9-conductor cable and I have 
used as long as about 25 feet without 
any problems. It is convenient 



however, to have the Smartrnodem 
near your computer setup, then you 
can hear the dialup and the send and 
receive carrier tones when you begin 
communicating. There are many pro- 
gramming options you can choose with 
the Hayes Smartmodem, and these are 
extremely well documented in the ex- 
cellent Owner's Manual. |In case you 
have not guessed, I consider the Hayes 
Smartmodem my best computing pur- 
chase to date!). 

The BASIC program is menu driven 
for ease of operation. If you BREAK and 
then RUN the program again, the 
Smartmodem functions are cleared 
("AT Z" is sent to the modem). To 
write to the Hayes, you must access the 
port in concurrent I/O mode (XIO 40) 
and then use normal PRINT# com- 
mands. Now you can talk to your 
modem just like it was a printer with 
PRINT#5, "your modem command". 
To get back into the normal Atari mode 
use CL0SE#5. It is important to read 
back the information sent by the Hayes 
modem or else the program will hang, 
and pressing reset is the only way to 
recover. Also, the only way to ter- 
minate the program is by pressing reset. 

Now you can use a communications 
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package such as AMODEM or a similar 
program to commvmicate with bulletin 
boards or data bases. The program in- 
cludes a short subroutine to emulate a 
dumb terminal if you don't have a com- 
munications package yet. 

I know little to nothing of amateur 
radio operations, but with a few lines of 



BASIC and possibly some hardware, 
the Hayes Smartmodem can be made to 
send morse code. Auxiliary relay con- 
tacts are provided in the modem to key 
the transmitter automatically. It can- 
not however, be made to directly 
receive morse code. Diagrams describ- 
ing the modem to radio interface are 



found in the Smartmodem User 
Manual Appendix H. Obviously some 
nice commercial terminal packages 
exist for the Atari, but this program has 
made me happy for some time now. 
With the Hayes Smartmodem and the 
Atari Computer, I am sure you will also 
enjoy computer communications. 



Listing 1 












KELTY ENGINEERING" 


5 


GOTO 500 


530 


PRINT " 


10 


REM SIMPLE TERMINAL PROGRAM 




***********************" 


11 


REM TO GET AND PUT CHARS 


540 


PRINT : 


12 


REM TO AND FROM MODEM 




PRINT "CONNECT CABLES TO MODEM, 


13 


OPEN #1,4,0, "K: " 




" 


15 


OPEN #3,8,0, "E: " 


545 


PRINT "COMPUTER AND PHONE 


20 


eOSUB 400 




COMPANY." 


30 


IF PEEK (764) =255 THEN 60 


560 


PRINT "PRESS ENTER WHEN READY";: 


40 


GET #1,A:PUT #3, A 




INPUT Hi 


50 


PUT #5, A 


570 


PRINT "}" 


60 


STATUS #5, XX 


580 


60SUB 400:PRINT #5, "AT Z": 


70 


IF PEEK (747) =0 THEN 30 




GOSUB 450 


SO 


GET #5, A: IF A = THEN 30 


590 


REM *************************** 


90 


PUT #3, A: GOTO 30 


600 


REM MENU 


1 1 


REM SMART300 


610 


PRINT : PRINT "1 AUTO DIALING" 


102 


REM KELTY ENGINEERING 


620 


PRINT "2 AUTO ANSWERING" 


103 


REM WRITTEN BY JOHN R. KELTY 


660 


PRINT "SELECT ONE OF THE ABOVE" 


104 


REM LINCOLN, NEBRASKA 68505 


670 


INPUT A* 


105 


REM 


680 


ON VALiA*) GOSUB 700, 1310 


106 


REM USE THIS PROGRAM TO CONNECT 


690 


GOTO 510 


107 


REM AND PROGRAM THE HAYES 


700 


REM *************************** 


103 


REM SMARTMODEM TO THE 


710 


REM AUTO DIALING ROUTINE 


109 


REM ATARI COMPUTER. 


720 


REM *************************** 


110 


REM 


730 


REM 


ill 


REM T;IE MODEM CABLE SHOULD 


740 


PRINT "3AUT0 DIALING" 


! 2 


REM CONNECT TO THE 850 


750 


PRINT "1 DIAL A SAVED NUMBER" 


i 3 


REM INTERFACE MODULE, 


760 


PRINT "2 DIAL A NEW NUMBER" 


140 


REM PORT #1 


770 


INPUT A* 


210 


REM 


780 


ON yAL(A*) GOTO 300,980 


220 


REM THE 300 PAUD HAYES MODEM 


790 


GOTO 740 


230 


REM MAY BE USED WITH AMODEM 


800 


REM *********************** 


240 


REM OR ANY OTHER TERMINAL 


810 


HM=2:REM HOW MANY NUMBERS 


250 


REM PACKAGE THAT ALLOWS THE 


820 


REM TO CHANGE THIS LIST, 


260 


REM HAYES TO RUN AT 300 BAUD. 




MAKE HM=HOW 


2 70 


REM 


825 


REM MANY # YOU WANT TO LIST ^MAX 


2S0 


REM THE HAYES WILL OPERATE 




OF 9) . 


290 


REM LOCALLY AT HIGHER RATES 


830 


REM THEN INSERT LINES SIMILAR TO 


300 


REM BUT NO HIGHER THAN 300 




THOSE 


3 1 


REM WHILE ON LINE. 


835 


REM BELOW WITH YOUR NUMBERS AND 


320 


REM 




NAMES. 


330 


REM SEE- YOUR USER'S MANUAL 


040 


PRINT "1NUMBER3 YOU CAN EASILY 


340 


REM FROM HAYES FOR DETAILS. 




CALL": RESTORE 


350 


REM 


850 


DATA "1 tU-UU ft 


360 


REM *************************** 




FRIEND " 


370 


REM 


860 


DATA "2 XXX-XXX-XXXX A BBS 


400 


OPEN #5, 13,0, "R:" 




M 


410 


XIO 38,»5,0,32,"R:" 


870 


FOR K=l TO HM 


420 


XIO 40,#5,0,0,"R:" 


880 


READ Al: PRINT A* 


430 


RETURN 


890 


NEXT K 


450 


GET #5,XX:GET #5, XX 


900 


PRINT "SELECT ONE OF THE ABOVE" 


460 


GET #5, XX: 


910 


PRINT "(BREAK AND LIST TO EDIT 




IF XXOIO THEN PRINT CHR*(XX); 




THESE NUMBERS)" 


4 70 


IF XXOIO THEN 460 


920 


INPUT Al: RESTORE 


490 


CLOSE #5: RETURN 


930 


NB=VAL(ft*) 


500 


DIM Al(30) ,P$(16) ,DPI(2) 


940 


IF NB<1 OR NB>HM THEN 800 


510 


PRINT "} ***** SMART MODEM 


950 


F.OR K=i TO NB:READ AIiNEXt K 




*****" 


955 


F^I = A$(5,i6) 


520 


PRINT " BY: 


960 


GOSUB 1090 
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9 70 RETURN 

980 REM ******** i- #«***** t: ♦ fr **■♦*** * 
990 PRINT "DIALING A NEW NUHBER" 
iOOO PRINT "TYPE IN THE PHONE NUMBER 

THAT" 
1005 PRINT "YOU WISH TO CALL. " 
1010 PRINT "EXAMPLES: " 
1020 PRINT " i -SOO-XXX-X XXX LONG 

DISFANCE" 
1030 PRINT "1 i2--800-XXX-X!fxX FROH 

LINCOLN" 
1040 KRINT "XXX-XXXX LOCAL 

CALL " 
iO&O PRINT "TYPE DESIRED NUMBER ";: 

INPUT Pf 
10/0 GOSUB 1090 
1080 RETURN 
J 9 L' REM **************************** 

1100 REM NUMBER KNOWN AT THIS POINT 
1 110 REM READY TO DIAL 
1 120 GOSUB 400 ; 

PRINT #5, "AT FO T D";P*: 

GOSUB 450 
1130 REM IF YOU NEED PULSE DIALING 

THEN 
1140 REM SUBSTITUTE A 'P' IN ABOVE 

LINE 
1160 REM ***■********•*»******#****** 
1170 REM YOU CAN LOAD ANY TERMINAL 
1180 REM PACKAGE THAT YOU WISH BY 
1190 REM EDITING THE NEXT LINES. 
1200 REM RUN "DsAMODEM" 
1230 PRINT "YOU NEED TO USE YOUR 

OWN" 
1240 PRINT "TERMINAL PACKAGE AT THIS 

POINT" 
1250 PRINT "(SUCH AS TELELINK AND 

OTHERS) . " 
1300 GOTO 2040 

1310 REM ****#*******#***#*** 
1320 REM AUrO ANSWER ROUTINE 
1330 REM »********»*****#*#«■» 
1340 REM 

1350 PRINT ">AUTO ANSWERING" 
1360 PRINT 
1370 REM MENU 

1330 PRINT "1 DO NOT ANSWER" 
1390 PRINT "2 ANSWER IMMEDIATELY" 
1400 PRINT "3 ANSWER AFTER XX RINGS" 
1440 PRINT "SELECT ONE OF THE ABOVE" 
1450 INPUT A* 

1460 PRINT "} AUTO ANSWERING" 
1470 ON yAL(An GOSUB 1490,1560,1720 
14S0 GOTO 1310 

1490 REM ******#*#***#*#********** 
1500 REM DO NOI ANSWER 
1510 PRINT " *#*DQ NOT 

ANSWER*** " 
1520 PRINT "THE SMART MODEM ANSWER 

FUNCTION" 
1530 PRINT "IS DISABLED. " 
1540 GOSUB 400:PRINT #5, "AT S0=0": 

GOSUB 4 5 
1550 GOTO 2040 

1560 REM ****#***»*****##**»***#** 
1570 REM ANSWER IMMEDIATELY 
1580 PRINT " *#*ANSWER 

IMMEDIATELY***" 
1590 PRINT "THE SMART MODEM WILL 

ANSWER ALL" 



UOO PRINT "CALLS IMMEDIATELY." 
1610 PRINT "USE THIS TO TRANSFER 

CALLS THAI" 
1620 PRINT "ARE ALREADY IN PROGRESS 

BETWEEN" 
1630 PRINT "TWO INDIVIDUALS TO 

COMMUNICATION" 
1640 PRINT "BETWEEN THEIR 

COMPUTERS. " 
1650 GOSUB 1670 
1660 GOSUB 400:PRINT #5 , " AT " ; DPt ; "A" ; 

GOSUB 450 
1670 PRINT "AT THIS POINT YOU NEED 

TO RUN" 
1680 PRINT "YOUR OWN RECEIVER" 
1690 PRINT "PROGRAM TO INTERPRET 

THE" 
1700 PRINT "INCOMING CALL. " 
1710 GOTO 2040 

1720 REM #**»**************** 
1730 REM ANSWER AFTER XX RINGS 
1740 PRINT " «#*ANSHER AFTER XX 

RINGS***" 
1750 PRINT : 

PRINT "THE SMART MODEM WILL 

ANSWER ALL" 
1760 PRINT "CALLS AFTER THE NUMBER 

OF RINGS" 
1770 PRINT "YOU SELECT (FROM i TO 

255 RINGS) " 
1780 PRINT 
1790 PRINT "HOW MANY RINGS (i TO 255) 

";: INPUT RG 
1800 RG=INT(RG) 

1810 IF RG<1 OR RG>255 THEN 1790 
1820 PRINT : 

PRINT "THE PHONE WILL BE 

ANSWERED" 
1830 PRINT "AFTER";R6;"RINRS. " 
1840 GOSUB 1870 
1850 GOSUB 400: 

PRINT #5,"AT";DP*; "S0="iRG: 

GOSUB 450 
1860 PRINT :G0TU 1670 
1870 REM ##*##*##♦**»*#»#********* 
1880 REM FULL OR HALF DUPLEX 
1890 PRINT : 

PRINT "DO YOU WANT FULL OR HALF 

DUPLEX?" 
1900 PRINT "(IF YOU DO NOT KNOW, 

TRY HALF) . " 
1910 PRINT :PRINT "1 FULL DUPLEX" 
1920 PRINT "2 HALF DUPLEX" 
1930 INPUT A* 

1940 ON VALiH*) GOTO 1950,1990 
1950 REM FULL DUPLEX 
1960 0P*="F1" 
1970 PRINT : 

PRINT "FULL DUPLEX SELECTED." 
1980 GOTO 2020 
1990 REM HALF DUPLEX 
2000 DP$="FO" 
2010 PRINT : 

PRINT "HALF DUPLEX SELECTED." 
"20 PRINT 
30 RETURN 

40 REM ******************** ic**** 
50 REM EXIT ROUTINE 
70 PRiiNT "THIS PROGRAM HAS ENDED." 
2080 GOTO 10 JMCftO" 
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Atari Player enables you to play music 
on your Atari. It converts the Atari into 
a simulated organ with the organ keys 
being represented by the keys on the 
Atari keyboard, as shown above. Each 
note you play can be heard over one of 
the Atari voices. The keyboard spans 
three complete octaves, beginning with 
a low C and ending more than two 
octaves higher with a B. Each note that 
is played is stored in memory so that it 
can be instantaneously replayed and 
then saved on cassette tape or disk. 
Later you can load your song in again 
and replay it. 

We have included a feature in Atari 
Player that allows you to stop playing, 
go back to correct mistakes, replay the 
song from the beginning to the current 
note, and then continue playing addi- 
tional notes. Absolute perfection is 
possible using the editing option 
[number 5), which allows you com- 
plete control over every note that has 
been played. You can change the tone, 
octave, and/or duration of any of the 
notes; or, if you wish, you can add 
more notes or remove them altogether. 

With the Atari Player installed in 
your computer you can make your 
Atari a musically instructive as well as 
entertaining device. 
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Operating Instructions for Atari 
Player Demonstration 

The first time you use the Atari Player, 
you should listen to the song already 
provided on your cassette or disk to ap- 
preciate how much can be accomplish- 
ed. To do this, follow the simple steps 
listed here. 

1. Using standard Atari loading pro- 
cedures, load Atari PLAYER. If you 
are using a cassette, leave it in the 
cassette unit; do not rewind it. 

2. Type 'RUN' followed by the 
'RETURN' key. 

3. You will be presented with the infor- 
mation that appears on the display 
screen below. 

4. Press the 4 key to select the 'LOAD 
SONG' option. 

5. The display will ask for the file 
name under which the song is 
stored. 

6. If you are using a cassette, type 'C:' 
followed by the 'RETURN' key. This 
will cause the next file [a prerecord- 
ed song) on the cassette to be loaded. 
If you are using a disk, then type 
'D:SONG' followed by the 
'RETURN'. This will cause the song 
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already provided in the file 
'D;SONG' to be loaded into your 
Atari. 

7. When the song has been loaded. 
Atari Player will tell you how many 
notes have been loaded, wait a few 
seconds, and then return to the 
original menu. 

8. Press the 2 key to select the 
'REPLAY SONG' option. 

9. You will now be treated to a rousing 
song played automatically on your 
Atari computer. 

Using the Atari Player 

After choosing the 'PLAY SONG' op- 
tion from the menu, the program will 
prompt you for the name of your song. 
(This is not the same thing as the file 
name that disk users have to supply 
when performing a save or a load. The 
name is saved with the song just for 
convenience and has no bearing on the 
song itself.) Then a representation of 
the Atari keyboard is printed on the 
screen in the format of a two-keyboard 
organ. The bottom row of keys 
represents the lowest notes, starting 
with 'C' and ascending alphabetically. 
The second row of keys represents the 
sharps and flats (black keys) that cor- 
respond to the first row. Note that 
there are inbetween keys on the second 
row of the Atari for every pair of first- 
row notes. This is different than the 
normal organ keyboard and means that 
some of the second-row keys do not 
sound when pressed [A, F, and K). 
These keys can be used to introduce 
rests into your song. 

The third row of keys represents the 
second keyboard of the organ, starting 
at middle 'F' and ascending to high 'B'. 
The top row of keys represents the 
sharps and flats corresponding to this 
second keyboard. When you have 
mastered the keyboard, you are well on 
your way to composing your own 
music. Read on. 

At the beginning, the program waits 
for you to start the song. This is one of 
the few times when a pause doesn't 
count. Once you start playing, the 
computer keeps track of every note and 
its length exactly as you play it. Prac- 
tice a bit to get the feel of the keyboard. 
It is not as simple as a piano, especially 
with the letters on the keys distracting 
you from what the true note is. The 
white keys on the display have the ac- 
tual name of the note printed over the 
keyboard name of the key to help keep 
you oriented. 

After you start a song, you may 
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discover that you didn't mean to play a 
particular note. Fortunately there is a 
mistake-recovery method. As soon as 
you realize that you have made an error 
(sometimes the first note is an error], 
press the space bar to pause momen- 
tarily. You will be presented with 
several options. 

1. CONTINUE allows you to start 
playing the song at exactly the point 
where you stopped. This is a useful 
technique for the times when you 
become confused as to which note 
you want to play next; press the 
space bar to pause, regather your 
wits, and press 'C to continue from 
where you stopped. 

2. REPLAY will play the song up 
through the current note so that you 
can inspect your masterpiece as you 
input and make corrections if 
necessary. This option can be chosen 
as many times as you need it. 

3. BACKUP is the option for which 
you've been waiting. This allows 
you to remove one note at a time 
from the current song, all the way 
back to the beginning if you want. 
When you make a mistake and press 
the space bar to pause, press the 'B' 
option and the note you are erasing 
will sound. Another 'B' will erase 
the next note, and so on. Then press- 
ing 'C will allow you to continue 
your song from the point to which 
you have backed up. 

If, no matter how hard you try, you 
can't seem to get the song perfect, then 
the next step is to use the editor (option 
5), which will allow you to manipulate 
the more obscure aspects of your song. 

Using the Editor 

The Editor option enables you to fix 
any minor (or major) mistakes that 
may creep into your performance. It 
allows complete control over every 
note in your song; the note, octave, and 
duration can all be changed to your 
specifications. And when using the in- 
sertion feature, you can start from 
scratch and construct your own song 
without ever playing a note on the 
Player keyboard! The Editor option is 
the perfect complement to Atari Player. 
The first thing that the editor does 
is to list the notes currently in memory 
in groups of 30. These are notes that 
have been either entered from the 
keyboard or loaded in from a previously 
saved song. The 'Next' and 'Previous' 
commands allow you to page forward 
and backward through the note tables 



Listing 1: Atari Player/Editor 

Xe REM ATARI F»l_ A YER/'EDXTOR 

30 OPEN m, 4, O , "K : ■■ : GO^UB IZOOO 

40 G03UB loeoe 

50 GET tSJ., A:IF A<49 OR A>55 THEM 5 

e 

ee A = A — 48:G03UB A^l Oee:GOTO 40 
XOOO PRXNT : PRXNT "Input: song naMe 

. . ."•; : XNPUT B5:ir BS = '"' THEM B 

S="MOMAME" 

xexo Kf = 

XO^XeXS GO^UB X4000 

X020 D=e 

X030 D = I> + X : A = PEEK C7643 : XF A = 255 TH 

EN X030 
Xe40 POKE 764 , 255 : G09UB 95ee:SOUND 

e, e , e., o 
xoeo xr a=x2 then sound e,e,e,e:MA 

X = V*X : MCV-t-XJ =o : GOTO XX2e 
Xe70 XF A = 33 THEN MAX = U-*-X : GOS UB SO 

ee : GOTO xex5 

Xese XF A>62 THEN A=3 

Xe9e TP=A : 50UND e, ASC CPITCH^ CTP+X, 

TP + XJ J , D5, l_ 
XXee V = U + X:XF U = I-N then HCU3=e:GOT 

o xx2e 
xxxe GOTO xe2e 

XX2e POKE CF,,e:RETURN 
2eee ? •■nPLAYXNG" : U=:X 

2exe IF Mcu3=e then ? "tno song in 

MEMORY" : GOTO 9000 
2020 G03UB 9200: IF TP=e AND 0=0 TH 
EN RETURN 

2030 SOUND e, e., e, e : GosuB 98ee:u = v + 

X : IF U>=MAK THEN SOUND 0,0,0,0 

: U=:'V = U—X : RETURN 
2040 IF PEEK C764} 0255 THEN POKE 7 

6 4, 255 : RETURN 
2050 GOTO 2020 
3000 GOSUB 9XeO:OPEN St2 , 8 , O , FS : TR A 

P 3500 
30X0 PRINT «S2,;BS 
3020 FOR U = X TO MAK:? SX2;MCU3 :NEKT 

U 
3040 CLOSE »«2 : ? "SAVED ";MAK — X;" N 

OTE3 TO ";FS:GOTO 9000 
3500 CLOSE «2 : ? "FILE I/'O ERROR": G 

OTO 9XXO 
4000 GOSUB 9XeO:OPEN ttZ , 4 , O , F $ : TR A 

P 3500 
40Xe INPUT *t2,B^ 
4020 INPUT «t2;A:MCU3=A 

4030 IF A>0 THEN U=U+X:GOTO 4020 
4040 MAX=U: CLOSE «2 : ? "LOADED " ; MA 

K-X;" NOTES FROM ";FS:GOTO 900 

e 

5000 POKE 20X,S:P0KE CF , X : POKE 82. 

O 
5020 U=0 
5030 POKE CF,X:POKE 703,Z4:PRINT " 

ncURRENT SONG: ";B$ 
5032 POSITION 0,X:PRINT "t^HMK^^KIM 

";:COLOR 2 : PLOT X8,2:DRAMTO X8 

, X9 
5040 FOR >CK = 2 TO 22 STEP 20:F0R YY 

= 3 TO X7:M = M-t-X 
S060 GOSUB 9200 : IF MCV3=0 THEN MAX 

=M:POSITION MH,YY:PRINT "END": 

GOTO 5X30 



50 



MICRO 



No. 68 - January 1984 



506Z MO=ft3C CNTOCT5 CTP+A , TP+iJ i :0=I 
NTCNO/ISS : V=NO— IMT CNO/ASJ^iS : N 
5 = NTSf CV«2 + i, V«2 + 23 

508e P03ITX0N KK,VY:PRIHT Kf , H^ i •' 

•• ; o ;'• ■"; D 

5090 NEKT VY : NEXT KK 

5X3e P03XTI0N , ZO Z POKE 7e3^4:POKE 

5±40 PRINT "[UEKT, QREUXOU^, QURRE 

NT, OR Ll]'":ftS = INPUT A5:PP = U: 

IF A$ = '"' THEN AS = "Z" 
5X5e U = e : IF A3CCA$3>=:48 AND A3CCA^ 

3 < = 57 THEN U = UAI_ CA53 : PP = PP-30 
5X60 IF U=0 THEN 5436 
5A70 PRINT "BHANGE, GJELETE, OR D 

N3ERT"" 
5180 GOSUB 5540 : IF Ck^ = "C" THEN 520 

O 
5X90 GOTO 54.ee 
52oe G03UB 9zee 

5240 IF MCV3=e THEN 5270 

5250 V=:A3C CNTOCT5 CTP + A, TP + AJ a : = IN 

TCY/ISJ : N=V— INT CY/ASJWIS 
52ee PRINT ■■tSNOTE NUMBER: " J V 
5270 A*="" : PRINT "NEW LENGTH :",: IN 

PUT A5 : IF A5f = *"" THEN 5140 
5280 IF A50"/" THEN D = UAI_CA^3 
5290 A5="" : PRINT "NEM NOTE : " , : IN PU 

T A5 : IF AS="" THEN 5390 
5300 IF ASO"/" THEN N^ = A^ : IF rF LENC 

N^3>2 THEN 5290 
5302 IF l-ENCN^3=I THEN N5 C23 =" '■ 
53iO FOR N=0 TO A2:IF NTSCN«2+I,N« 

2+23 <>N^ THEN NEXT N:PRINT "TN 

OTE NOT FOUND .*■: GOTO 5290 
5320 AS=:"" : PRINT "NEM OCTAUE:",:lN 

PUT ASf : IF AS = "" THEN 5390 
5325 IF VAI_CA^3>2 THEN A5 = "2" 
5330 IF A50"/" THEN = UAI_CA^3 
5390 NT=:N + 0«A2 : FOR TP = TO 62:IF A 

SC CNTOCTS CTP+X , TP+A3 J <>NT THEN 
NEKT TP 
5392 G03U0 9500: REM PACK IT INTO M 

CVS 
5400 Kf — Kf*X Z GOTO 5200 
541.5 IF U<0 THEN V = 
5420 PRINT "tS" : GOTO 5030 
5430 IF AS = "P" THEN M=rPP-60 : GOTO 5 

415 
5440 IF AS<>"N" THEN 5450 

5442 POKE 7e3^24:PRINT "•S":IF PP+2 
9>MAK THEN PP=:MAK-30 

5443 IF PP<0 THEN PP=0 

5444 U=PP:G0T0 5030 

5450 IF AS=:"C" THEN V = PP-30:G0T0 5 

4±5 
5458 RETURN 

5480 IF A5="D" THEN 55IO 
5480 FOR I=MAK TO V 3TEP — A:WCI+I3 

= MCI3:NEKT I : MAK=:MAX + I : GOTO 51 

40 
55IO FOR I = V TO MAX : M CI3 =:M CI + I) : NE 

XT I : MAX = MAX-1. : GOTO 5I40 
5540 GET t*X , A : A^=CHR^ CA3 : IF A^ = "" 

THEN 5540 
5550 RETURN 
5999 END 

eooe ? :? :? " TEMPO = ";3 

60Xe ? " NEW TEMPO = "; : IN 

PUT S 
6020 IF 3<X THEN 60X0 



so that you can look for the note (or 
notes) that you wish to change. The 
'Current' command simply redisplays 
the table starting at the same note. 
This option is usually used after an in- 
sert, delete, or change to see how the 
song looks. 

The ' # ' option allows you to change 
the current notes in memory, one at a 
time. Note that the editor does not 
want the number sign itself; it is expec- 
ting a number. Also, it does not change 
any notes on the tape or disk, so don't 
worry about making a mistake. Experi- 
ment with changing notes and then 
play them together to see how they 
sound. 

Pressing the return at the 'NEW 
LENGTH:' prompt will return you to 
the main menu. Pressing return at any 
other prompt will leave the rest of the 
parts of the note unchanged and skip 
ahead to the next note. This allows you 
to change the lengths without re- 
entering the remaining values that you 
don't want to change. 

Pressing the '/' and return at any 
prompt preserves that one value and 
jumps to the next prompt. For example, 
if you don't want to change a value, 
such as length, but do want to change 
the note or octave, press '/' and it will 
skip over the values you want to save 
without your iaving to retype them. 

The insert option moves all the 
notes (including the one whose number 
you entered) forward one position and 
then returns you to the 'Next, 
Previous, Current, or #' prompt. You 
might want to use the 'Current' option 
now to see how the song looks. Change 
the note that was at the point of inser- 
tion to whatever specifications you 
want and you have just entered a note. 

Delete moves all the notes follow- 
ing the one you specified down one 
position, effectively erasing that note. 
As with the insert option, you will be 
returned to the 'Next, Previous, 
Current, or #' prompt. Again, you may 
want to use the 'Current' option to see 
how the song looks after the deletion. 

When you are prompted for a new 
note, the only notes that will be ac- 
cepted are 'C, 'C#', etc., as listed in 
the data statement (line 13010). A rest 
is indicated by ' [ j ' . The program looks 
up your note in the note table and con- 
verts it into the number that represents 
that particular note. If it can't find that 
note, it will give you the '?NOTE NOT 
FOUND.' error and return to the 'NEW 
NOTE' prompt to give you another 
chance to change it. 
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Other Menu Options 

There are five additional menu 
options that allow you to hear your 
song, load a song from or save a 
song to the tape player, change the 
tempo of the song, or quit. 

Choosing option 2, 'REPLAY 
SONG, ' will play the song current- 
ly in memory over the television 
speaker. The routine uses the cur- 
rent tempo for the speed at which 
to play the song. If there are no 
notes in the song, then the error 
'?NO SONG IN MEMORY' is 
printed and you are returned to the 
menu. 

'SAVE' and 'LOAD' options are 
numbered 3 and 4, respectively. To 
save the current song, choose op- 
tion 3 and enter the file name of 
the song to be stored. If you are 
using a cassette you can specify on- 
ly 'C:' as your file name. If you are 
using a disk, the file name must be 
a standard disk file name. Note 
that this file name and the name of 
the song you specify when you 
choose option 1 (PLAY SONG) are 
not the same. The name refers to 
the name that you wish the song to 
be titled — for the sake of conve- 
nience only. The file name is mere- 
ly where you want the song to be 
stored and applies only to disk 
users. If you are using a cassette- 
based system you will be prompted 
to press PLAY and RECORD on the 
tape player. When the song is sav- 
ed, the number of notes and the file 
in which they are saved are 
displayed and you are returned to 
the menu. If you are using the tape 
player, it will stop. 

Option 4 is similar in operation 
to option 3. Remember that when 
you LOAD a new song, you will 
erase any song currently in 
memory; you must SAVE the cur- 
rent song (if you want to keep it for 
later use) before loading a new one. 
The file name prompt will now 
appear. (If you are using a cassette, 
there are no file names that you 
can specify. The tape will read 
from where it was left last.) When 
the song is loaded, as when saving, 
the number of notes and the file 
they were in are displayed and you 
are returned to the menu. Again, if 
applicable, the tape player will 
stop. 

To change the current tempo 
setting, choose option 5. The 
minimum (fastest) setting allowed 
is ' 1 ' . There is no restriction on the 
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e RETURN 
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■■•%•• : POSITION 

■■CHOICES : ■■ : ? 
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GOSUB 554e:REM 
IF a^="C" THEN 



cs e : E 

OSUB 9 
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ND 

2ee 



ND e, e, e, e : RETUR 

e IF a^="R" THEN 

o 8oie 

e IF AS<>"B"" THEN 
e IF W=e THEN 867 
e GOSUB 92ee:G03U 

e SOUND e,ej,e,e:G 
e FOR 1=1 TO 3eej^ 

e PRINT IPRINT 

^■ja.faj.i--i„L 
5 PRINT ••En1:eo f± 

PUT FS 
e U = X:IF F^<>'"C:^' 
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e TP = iNT cMcvj /'lee 
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e IF D>999 THEN D 
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e SOUND e,ASCCPIT 
, DS, U 
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E CF, A : SETCOLOR 
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maximum (slowest) setting, except 
for the fairly large internal limits of 
the Atari. However, even a setting 
of just 100 will result in extremely 
long notes. 

When you are finished with 
Atari Player and want to return to 
BASIC, choose option 6. Alv/ays 
remember to save any song that 
you are currently working on 
before choosing this option. If you 
forget this rule, typing 'GOTO20' 
might enable you to return to the 
program without losing your song. 

Programming Concepts 

Using a Menu to Make a Choice 

1. Input witii a Single Keystrolte 

Normally input from devices is 
done with the INPUT statement. The 
only limitation of this statement is that 
it requires the input data to be followed 
by a carriage return. Thus, any input 
from the keyboard using this method 
would require at least two keystokes — 
No. 68 - January 1984 



one for the character being input and 
one for the return key. The way around 
this is illustrated in program lines 30 
and 50. 

Line 30 opens the keyboard for in- 
put. This means exactly what it seems; 
you can now input from the keyboard. 
The open statement is usually used for 
access to files on cassette or disk, but it 
can be used for any connected device, 
such as the keyboard and even the 
screen. The device specification for the 
keyboard is 'K:', which is the open 
statement's fourth parameter. 

Because a single keystroke input is 
preferred, the keyboard input for the 
menu (line 50] is done with a GET. The 
GET statement waits for one character 
of data from the keyboard; i.e., the 
single keystroke. Thus no carriage 
return is required and an option may be 
selected by striking a single key. 
However, the data input is not a 
character, or a letter, but rather a 
number. This number is the numerical 
representation of the typed letter and is 
called an ASCII code. 
MICRO 



2. ASCn Codes 

Because computers cannot handle 
anything other than numbers, a 
method for handling characters such as 
punctuation marks, letters of the 
alphabet, or any other character, is 
needed. What has been devised is the 
ASCII codes (American Standard Code 
for Information Interchange), which are 
numerical representations of each 
character for the computer to handle 
internally. Most users never see these 
numbers for they are converted back to 
characters when displayed on the 
screen, but they are neccessary when 
dealing with such specific statements 
as the Atari GET. 



3. Using a Menu to Make a Choice: 
Selection by Number 

When you run Atari Player, the first 
display that you see is a list (or menu) 
that tells you what options are 
available. Each item on the menu is 
selected by pressing the number 
associated with it. The BASIC program 
steps required to evaluate your choice 
are in lines 50 and 60. 

nm GET tti..As 

IF ft<*3 OR 

A>ss thc:m «• 

ft* A=;A-40 I G03UB 

AM^xoeeiGOTo ab 

Line 50 gets the ASCII code for the 
keyboard character pressed and stores it 
in variable A. The following IF. . .THEN 
statement checks to see whether or not 
the character typed was a number. 
Note that, as stated above, the GET 
statement gets the internal code for the 
character typed rather than the 
character itself. This means that the 
program has to check for the characters 
1-9 rather than the numbers 1-9. If A is 
less than 49 ( ASCIIl ) or greater than 5 5 
(ASCII 7), then the character typed is 
ignored and the program returns to line 
30 to get another choice from the 
keyboard. 

Line 60 does the actual branching to 
the appropriate routine. Since the only 
options available are listed 1 through 7, 
and the program routines for each start 
on the line numbers that are multiples 
of a thousand (1000-7000), the bran- 
ching to these routines can be done by 
formulae. All that is needed to branch 
to the appropriate routine is to multi- 
ply the option number chosen by 1000 
and then perform a GOSUB to that 
result. Thus, 48 [ASCII 0] is subtracted 
from the code in A to convert it to one 
of the numbers 1-7. Then a GOSUB to 
the line number A * 1000 is performed. 
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This is a useful space conservation 
technique. The only other way to do 
this would be to have a fairly large 
ON...GOSUB statement followed by 
the starting line number of every 
subroutine. 

4. Selecting by First Letter 

If the space bar is pressed during the 
'PLAY SONG,' then another menu is 
displayed. 

The first character of each item is 
displayed in reverse video to indicate 
which letter is to be pressed on the 
keyboard to select that choice. The 
routine that gets the characters from 
the keyboard is at line 5540. Note that 
this routine converts the number put in 
variable A into a string (A$) via the 
CHR$ command. This is done so that 
the routine will return a string holding 
the choice as opposed to returning the 
ASCII value of the choice. That is, this 
routine returns a letter, which is then 
serviced by its own IF...THEN- 
statement. 



tirely. For the beginner, using this loca- 
tion is rather difficult as the codes 
follow no obvious pattern. For in- 
stance, a space is a 33, the letter A is 
63, the B is 21, and so on. Therefore, 
the user must know which keys to ex- 
pect ahead of time. The following short 
routine can be used to discover the 
various key codes. After typing RUN, 
simply hit a few keys; their correspon- 
ding codes will come up on the screen. 

10 PRINT PEEK(764):GOTO 10 

Lines 1030, 1060, and 1070 show 
how Atari Player uses this location. 
Note that it is POKEd with 255 after be- 
ing read. This insures that the same 
key can be hit twice and registered as 
two keys. That is, because the location 
holds the last key hit, if you were to 
hit, say, the 'Z' key twice, and if the 
location was not reset after each read, it 
simply would not change from the first 
'Z' to the next. This means that two 
notes would be read as one (with a 



8078 G09UB 55-40 : R 

aase xr a$=:c them 
e,e,o.e:RETUR 

0090 IF A^:=R THEN 
ai.0O xr A$<>B THE 



EM GET ROUTXME 

GOSUB 92aa: SOUND 
M 

GOSUB 2eee:GOTO 

M OB7B 



If there are only a few choices, as in 
this example, then there is not a lot of 
code. If there were many choices, then 
the amount of code to service the 
letters could be significant. 

5. Accessing the Keyboard for Real- 
Time Situations 

The above method of selecting by 
first letter using the GET statement is 
fine for most situations involving input 
with a single keystroke, but it is severe- 
ly limited in real-time applications. 
This is because the GET statement 
actually waits for a key to be struck. 
For instance, suppose you were writing 
a game that needed to keep track of the 
elapsed time between keystrokes. This 
would be impossible with the GET 
statement because the loop required to 
keep track of the time could never be 
executed. Such was the problem in 
writing the PLAY SONG option, which 
has to keep track of such things. 

The Atari uses memory location 
764 as the place to keep the last key hit. 
That is, whenever a key is struck (no 
matter what program is running) loca- 
tion 764 is filled with a number that 
represents the last key pressed. But this 
number is not ASCII. This location 
uses the actual hardwired codes for the 
keyboard — a different set of codes en- 



rather long duration). Resetting loca- 
tion 764 also allows us to keep track of 
the duration in the first place (line 
1030). By checking for the 255, we 
know that the key has not yet been hit 
and that the duration should then be 
incremented. 

Space Saving with Arrays 

Atari Player uses many arrays — for the 
storage of its notes, keyboard entries, 
and other such internal data. There are 
many ways of storing this information 
in the arrays. This section deals with 
the most economical way possible for 
storing the types of information 
contained in Atari Player. 

1. Numeric Arrays 

Atari Player could have stored all of its 
information in the form of numerical 
arrays as all of its information is, in- 
deed, numbers. But numbers are very 
costly to store in BASIC arrays, 
especially on the Atari. Atari BASIC 



'eats' up 15 bytes plus 6 bytes for every 
cell in the array. This is not including 
the space that is eaten up by the 
variable name and the DIM statement 
itself. For example, an array that was 
dimensioned for 100 cells would eat up 
15 plus 6 times 100 — or 615 bytes! 
Therefore, the only array that we made 
numerical was W, and it was dimen- 
sioned for a whopping 501 cells. Over 
3000 bytes is used to store it. 

However, things could be worse. 
The W array has a little more informa- 
tion than normal crammed into it. In 
fact, that one array is made up of both 
the keystroke [for the note played) and 
the length of time that it is played. It 
was necessary to perform such a 
numerical combination to keep from 
wasting an exorbitant amount of 
memory. But before we get into such a 
space-saving trick, let's first examine 
■ how not to program the storage area. 

As mentioned briefly before, each 
note that you play involves two pieces 
of information that must be saved by 
Atari Player: the number (keystroke) of 
the note and the duration of the note. 

We could define a two-dimensional 
array that contains a number for both 
parts of each note: e.g., DIM W(500,l) 
would reserve space for 500 notes (the 
zeioth element is not used) with two 
numbers per note. How much memory 
do you think this would take? It really 
is deceiving. Since 500 times 2 is 1000, 
is that the total number of bytes re- 
quired? No! Each Atari BASIC array 
number requires six bytes of memory. 
Therefore, it would take 6 • 1000, or 
6000, bytes of memory! On a 16K Atari 
(which, by the way, has only 13000 
some bytes left after the operating 
system has taken its share) that leaves 
a little over 7K for the rest of the 
program. 

You have to get a bit tricky to 
squeeze more out of the song space; but 
there is nothing wrong with getting 
tricky when writing programs. In fact, 
that can be half the fun! To really 
squeeze the memory in Atari Player, 
we took advantage of the size of the 
number that the Atari arrays can hold. 
The two values that we need to keep for 
each note played are the note number 
(0 to 38] and the duration (which is 
limited to to 999 units). If only we 
could pack both of these individual 
values into a single number for storage 
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539Z GOSUB 9500 : REM PACK XT XNTO MCV3 



9SOe xr D>999 THEM D=999 

9SJLO HCV>=XMTCTf»4»J.OBe-t-D> XRCTURM 
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and then unpack them when we needed 
to use them. Well, good news — we 
can! 

The technique to pack the numbers 
is shown in line 5392. 
This equation is not as difficult as it 
may at first appear. 

W (V) is the array of notes where V 
is the number of the note in 
the song 

+ TP * 1000 multiplies the 
keystroke number (0 to 63) by 1000 

+ D adds the duration value (0 to 
999) 

All we have done is multiply the 
keystroke value that we need to save by 
enough to make sure it does not overlap 
with the duration value. This insures 
that we will be able to unpack the 
separate parts later. The unpacking is a 
bit more difficult than the packing, but 
conceptually it is simple. All we need 
to do is reverse the packing process. 
This is accomplished in the following 
lines: 



elements are of equal size this is fairly 
simple because the starting character 
position of any of the elements can be 
calculated using the index. Take for 
example the following lines: 



end of line 5062. Note that the 
elements in this case must be two 
characters long: a note, 'C for 
instance, followed by either a space or a 
sharp sign, '#'. 



Ze NAME$="TOM DICK HARRYJIMBO 

RALPHBILLV 
iOO XNPUT XNDEK: REM INDEK 

STARTS AT O 

IJ-O PRXNT NAME^ CINDEKW5-I-1, INDEK 

X20 GOTO lee 



This routine simulates a string 
array where the elements are first 
names. In Atari BASIC, to get part of a 
string, you specify the string name 
followed by the starting and ending 
character position of the substring you 
want. In line 110, what is printed is the 
substring that starts with character 
position INDEX* 5 + 1 and ends with 
INDEX*5 + 5. Thus, because the 
character position is calculated, every 
element must be the same length. If 
they aren't, and this is usually the case, 
then the smaller ones must be padded 



9zeo 

92iO 



TP^INTCMCVl/'ieeOl 

D = Mcv} — TP«j.eee : return 



Line 9200 restores the note number 
by dividing by 1000. 

Line 9210 restores the duration by 
subtracting the note number 
multiplied by 1000. This simply 
returns the remainder that was sheared 
off by the INT 1000. 

The above lines of program take the 
single integer value and convert it back 
into two separate parts. This method 
results in a 500-note song requiring 
only 501 array slots to store it, at six 
bytes per number, for a total storage of 
just over 3000 bytes — only half the 
amount that would be needed if we 
stored the two values separately! 



2. Simulating String Arrays 

NT$ is a string that holds all the possi- 
ble note symbols. Normally these 
symbols would be entered separately in 
a string array, but the Atari does not 
have this capability. (It does dimension 
strings, but this refers only to the 
lengths of the strings and that doesn't 
help us much.) Instead, all string infor- 
mation must be concatenated, or 
'strung together,' one after another in a 
single string. This means that the only 
way to access the different elements is 
to access the different character loca- 
tions within the string. As long as the 
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with spaces. Every element must start 
at every character position that is a 
multiple of some number in order for 
this particular technique to work. 

The note symbols used by Atari 
Player are stored the same way. They 
are stored initially in line 13010 and 
then READ in as a single string (NT$) 
in the initialization routine at lines 
12000 through 12050. Assuming Y is 
the note number (0-12), the following 
routine will set N$ equal to the 
corresponding note symbol: 

10 N$ = NT$(Y*2-i-1,Y*2-l-2) 

In fact, this very routine is found at the 



There is another way that strings 
are used in Atari Player. It is a bit more 
complex but basically entails the same 
concepts. The difference lies in the fact 
that this method is used to store a 
series of numeric values such as would 
normally be done with numeric arrays. 
The savings are space and time and for 
the following reasons. 

Strings use up only one byte of 
memory per character. A little more is 
used up in the variable name and such, 
but that is essentially it. So, if we were 
to somehow convert every number that 
is in a numeric array (six bytes) to a 
string character (one byte), we would 
have a savings of five bytes per ele- 
ment. Thus, a numeric array dimen- 
sioned for 100 elements that would 
normally eat up 600 bytes of storage 
could be made to fit in merely 100 
bytes. 

Loading in the initial values in a 
string is very fast, whereas loading in 
the initial values in an array is tedious- 
ly slow. This is because string loading 
can be done with a single statement 
and all the elements can be loaded in at 
once; the elements in an array must be 
loaded in one after another in a loop. 
For arrays of ten elements or less, con- 
version to a string is hardly worth the 
effort because the loading is so short 
and, therefore, does not take up much 
time anyway. But for larger arrays, 
string conversion is definitely worth- 
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while because the loading time of even 
several minutes can be cut down to 
only a few seconds at most. 

Lines 12042, 13000, and 13020 
demonstrate how the strings are stored 
and read in. 

There are a couple of problems 
when working with these strings. First, 
when addressing the element you 
must, in reality, address the individual 
characters of the string. That is, the 
index that you would normally use to 
access any of the elements in the 
numeric arrays is now the character 
position in the string. But element 
positions in arrays start at zero (0] 
while string positions start at one (IJ. 
Therefore, when accessing the data in 
strings, you must either ignore the 
zeroth element entirely and start the 



element numbers off at one, or add one 
to the element number so that the ele- 
ment that was previously numbered 
zero will reside at string position one 
(1]. Line 9800 demonstrates how this 
latter method is used in Atari Player. 



number that could possibly be stored in 
one is 11111111 binary (255 decimal). 
Also, the number must be a non- 
negative integer. To get the number in 
the string as an element it must be con- 
verted to a character via the CHR$ 



9800 SOUND O, ASC CPITCHS CTP + Jl, TP + A3 3 
D5, L 



where TP is the index to the string 
array PITCH$. 

The second problem is a little 
tougher for the beginner to under- 
stand. Since each character in a string 
is essentially one byte of storage inter- 
nally, the size of the numbers you can 
store are limited to what a byte can 
store. Because, as you may know, bytes 
are only eight bits long, the largest 



function. This function will turn the 
number specified into the character 
whose ASCII value is that number so 
that it may be stored in a string. When 
accessing that element, to get the 
number from the character, the ASC 
function must be used. This function 
converts the string specified 
(presumably an element in the string) 
to its ASCII equivalent. (See Program- 
ming Concepts 2: ASCII Codes.) 



Atari Player Variable Usage 


Constants 




CF 


POKE location for cursor inhibit 


DS 


Sound distortion 


L 


Sound loudness 


LN 


Last element available in W array 


NT$ 


String 'array' of all note symbols 


NTOCT$ 


Note/octave conversion from keystroke 




number 


PITCH$ 


String 'array' of sound pitches for 




conversion from keystroke 


Variables 




A 


ASCII value from keyboard 


D 


Duration for current note 


I 


Loop counter 


MAX 


Position of the zero element in the song 




(end of song) 


N 


Note number (0-12) 


NT 


Actual note (0-12) plus octave (0-2) 


O 


Note's octave 


s 


Tempo setting (speed of song) 


TP 


Keystroke/note equivalent 


V 


Note pointer for song 


W() 


Array of notes and durations 


XX 


X position of editor's output 


YY 


Y position of editor's output 


A$ 


Input string from keyboard 


B$ 


Song name 


F$ 


File name 


N$ 


Note symbol 
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Sure 
ify insured? 

SAFEWARE^*' Insurance provides full 

replacement of hardware, media and 

purchased software after a low $50 deductible. 

As little as $35/yr covers; 

• Fire • Theft • Power Surges 

• Earthquake • Water Damage • .^uto Accident 

Select the coverage you iimitfrom the table. 

Amount of Insurance Annual Premium 



Vpto$ 2.000 


$35 


$ 2.001-$ 5.000 


$ 60 


$ 5.001-$ 8.000 


$ 75 


$ 8.001-$11.000 


$ 90 


$11.001-$14.000 


$105 



Call for higher coverages. 

Not avail m AK. IK, HI U \.\ ME MS. NV, SC, or *T. 

Call for immediate protection. 

1-800-848-3469 

(In Ohio call 1-800-848-2112) 



COLUMBIA NATIONAL GENERAL, .AGENCY 
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From Here to Atari 



by Paul S. Swanson 



The number of new peripherals you can add to your Atari 
computer has been steadily increasing. The ATR8000 is a 
device produced by SWP Microcomputer Product, Inc. that 
adds CP/M and a few other interesting capabilities. 
Another addition is a modem, which opens up a new 
direction to microcomputer users. In addition to the 
modems which can be attached to the Atari computers 
directly, any RS232C modem can be used either with the 
850 interface module or under CP/M with the ATR8000. 

The ATR8000 

This peripheral is actually a computer on its own and can 
be used with or without an Atari computer attached. It 
does have the standard Atari serial bus connectors, but it 
can use any RS232C terminal instead of an Atari, 
connected through its modem port. 

I have had an ATR8000 now for about a month and use 
it to connect three Radio Shack disks to my Atari 
computer. With such a setup, the drives can be used as 
Atari drives when not in CP/M mode, or as dual density 
CP/M drives in CP/M mode. 

Using the ATR8000 as a peripheral to the Atari 
computer (i.e., not in CP/M mode) allows mixing the 
drives so that drive 1 may be connected to the disk port of 
the ATR8000 and may be a Radio Shack or other non-Atari 
drive and drive 2 may be an Atari 810 or 1050 connected 
along the serial I/O bus. In the CP/M mode, an Atari 810 
or 1050 disk drive may not be used. 

Two other devices that can be directly connected to the 
ATR8000 are parallel printers and RS232 devices, such as a 
serial printer or a modem. When the ATR8000 is not being 
used for CP/M, it will act as a printer buffer for the printer 
connected to it. A 64K ATR8000 provides a 48K printer 
buffer. This buffer will work for any printer attached to the 
parallel port on the ATR8000. It does not work for printers 
that are connected using the Atari serial I/O bus or 850 
interface module. 

A modem can also be connected to the ATR8000 using 
its serial port. The modem must be RS232 compatible and 
is controlled directly by the ATR8000. The modem 
connected in this fashion is not available to the Atari 
computer as device "R:", but may be used under CP/M. A 
modem connected to the 850 interface may be used by the 
Atari computer as device "R:" when not in CP/M mode. 
There are several different configurations allowed with the 
ATR8000, particularly if you also have an 850 interface. 

There are also a few drawbacks to consider. The device 
does generate a large amount of television interference, 
particularly if you use a ribbon cable connector for the 
printer. It may even display an interference pattern on the 
television you use as a monitor for your Atari computer. A 
ferric core is supplied with the ATR8000 to suppress this 
interference (by wrapping the cable from the Atari to the 
television around it) on your monitor/television. Another 
problem is that you have to build cables. The pinouts are 



provided in the manual and the three ports on the 
ATR8000 are edge card connectors. The printer cable 
required the most work to assemble. The disk cable was 
relatively easy. The Radio Shack disk cables will work 
with no problem, even when using disks which are not 
Radio Shack disks. The only caution with using Radio 
Shack disk cables is that the drive selection is done in the 
cable, so you have to put the drives onto the cable in the 
correct order and the select on the disk drive must agree 
with the select on the cable connector. 

The ATR8000 manual explains how to alter a Radio 
Shack drive to use it on the ATR8000. I ran into a slight 
problem with that, however, because the Radio Shack 
drives I have are not the same kind as the ones described. If 
you try this and find you have the older Radio Shack 
drives, all that is required is to sever the only jumper 
across the connector inside the drive. When you open the 
drive, which wire to cut will be obvious. 

Since most "bare" disk drives will work with the 
ATR8000, including 8" drives with an alteration, it is 
tempting to get an ATR8000 and two drives from a surplus 
electronics store instead of two Atari drives if you are 
upgrading to a disk system. Careful shopping can result in 
drives for less than $150 each. The ATR8000 lists at 
$349.95 |16K without CP/M) or $499.95 (64K with 
CP/M), which adds up to $649.95 or $799.95 - less than 
the cost of the two Atari disk drives. You will still need the 
cable and a power supply for the disk drives, but if you do 
this, you will also have the printer connection with the 
48K buffer and a modem port, plus CP/M if you get the 
64K version, not to mention the ability to add a third drive 
for under $150 if the power supply is adequate for three 
disks. 

Using CP/M with an Atari does have one serious 
problem associated with it, which is that CP/M requires 
an 80-cblumn screen and the Atari screen has only 40 
columns. The software that accompanies the ATR8000 
contains a program that turns the Atari into a terminal for 
CP/M use. The screen is sectioned and moves back and 
forth to allow you to see the 80 columns with a 40-column 
window. 

There is a better solution for more serious CP/M users. 
Austin Franklin has provided the software on a cartridge 
for the 800 to allow use of his 80-column board with 
CP/M. The system runs on the Atari 800 computer. The 
80-column board and the software for using it for the 
ATR8000 is available from Austin Franklin Associates, 
Inc., 43 Grove Street, Ayer, MA 01432, (617) 772-0352. 
The 80-column board lists at $289.95 and the software 
allowing its use with the ATR8000 lists at $29.95. 

Telecommunicating with your Atari Computer 

Modems create one of the more unusual ways to meet 
people. All over the country there are free bulletin boards 
for computers to call. If you have a modem on your Atari 
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WORD PROCESSING 

TOTL.TEXT 

MAILING LIST AND LABELS 

TOTL. LABEL 

TIME MANAGEMENT 

TOTL TIME MANAGER 

KEYWORD CROSS REFERENCE 

RESEARCH ASSISTANT 

For Commodore 64™ and VIC 20™ 



cing fhe newest members of the family. . . 



BUSINESS ACCOUNTING 

TOTL. BUSINESS poR 

SPELLING CHECKER 

TOTL.SPELLER (64 only) 

DATABASE 
MANAGEMENT 

TOTL.INFOBASE 



FOR 



FOR 



^^f^^ ( RETAIL ) 
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TPTL 

SOFTWARE, INC. 

quality you can afford 



Ask your dealer about TOTL Software 
or send in the coupon for further 
details and ordering information. 



1555 Third Avenue, Walnut Creek, CA 94596 

PLEASE SEND ME MORE INFORMATION ON TOTL SOFTWARE 



Address: _ 



.Zip. 
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computer, you were probably informed amply about major 
national networks where you, for a fee, can tap in and take 
advantage of various services. In addition, there are many 
telephone numbers you can use to connect your computer 
to services that are completely free. 

These free bulletin board services, or BBS's, are run 
mainly by private individuals on many different types of 
microcomputers. They provide a public message base, 
which usually have some interesting conversations that 
you can jump into, as well as other features. Many have 
downloading sections where you can obtain copies of 
public domain programs for your Atari. Some have 
"feature articles" which are the electronic equivalent of 
magazine articles. Most have private mail capability to 
allow you to communicate with specific other users if you 
have something private to discuss. 

There are also games available for you to play on many 
of these BBS's while you are connected. Bulletin files may 
be read, which tell you things about the computer you 
have connected with or about some recent alterations in 
the services provided. Almost all of them also have a help 
file you can read, which tells you how to operate the BBS. 

I am now involved with two of these BBS's. One I 
mentioned in a previous column, which is the Atari World 
section of the Outpost (617-259-0181). Another I have set 
up on my Atari computer. This one, Nite Lite, is on line 
from 6pm to 6am (eastern time) at 617-576-2426. Both 
support message bases and have bulletins, help screens 
and games. Both also answer at either 300 or 1200 baud 
and have lists of other boards in this area. In the near 
future, I will post a list of several boards in other areas of 
the country, so you will be able to call the number for Nite 
Lite (please take careful note of the hours) and get a list 
containing numbers that may be closer to you. 

In many ways, these BBS's resemble the CB radios, 
which allowed communication between people who have 
never met. Some of the informality and lack of self- 
consciousness that CB radios created in conversations can 
be seen on the BBS's. The main difference between CB 
radio and the message bases of these BBS's is that the 
messages have to be typed and can be reviewed. It seems to 
result in more sophisticated conversation, almost always 
interesting and well worth reading. 

In addition to idle chatter, discussions concerning 
national or local politics, critiques concerning news items 
and other discourse, the message bases are also a very good 
source of help for you concerning, among other things, 
your computer. If you are having a problem and don't 
know how to solve it, you are looking for some hardware 
or just some advice on making a decision, all you have to 
do is post a message on one of the local BBS's. You will 
probably have several replies within a few days and if your 
problem is interesting, you may even see messages where 
other people have started discussing it on their own. 

The future of these free BBS's looks very promising. As 
an example of what can happen, both Nite Lite and the 
Outpost are members of BINEXNET, which is Boston 
INformation EXchange NETwork. One of the planned 
functions of this network is an exchange of mail (the 
messages) among the member BBS's. If this is 
implemented successfully, this network will be looking to 
tie into other networks around the country to exchange 
mail. The result, if successful, will be the electronic 
equivalent of letter mail, except there will probably be no 
charge. JMCftO" 

No. 68 - January 1984 



? Atari 



AMOK) 



TM 



Atari Reviews 




Product Name: VoiceBox D 

Equip, req'd; Atari 800 computer with 40K of RAM 

BASIC Cartridge Disk Drive 
Price: $124.95 

Manufacturer: The ALIEN Group 

27 West 23rd St. 

New York City, NY 10010 

(212) 741-1770 

Description: The VoiceBox 11 is a voice synthesizer that 
connects in daisy chain fashion to the computer just as the 
disk drives, etc. do. It is provided with three disks. These 
disks have the demo program plus programs and dic- 
tionaries which allow the use of speech or singing in your 
BASIC programs. There are also several games included 
which take advantage of the speech abilities provided. 

Pluses: The synthesizer may be used to include speech 
and/or music to any BASIC program. This can make 
educational programs much more interesting to younger 
children. You may also become a song writer and producer 
for the Atari. A talking, singing head is provided complete 
with lip movement to match the sounds. There are two 
versions, one is just the outline of a head with eyes, 
mouth, etc. while the other is full featured including hair. 
The latter was programmed by Jerry White and is quite good. 

Minuses: The use of the VoiceBox II is not easy if you 
want the sound to be realistic. The speech is reminiscent 
of someone from a Spanish speaking country who is learn- 
ing English. In order to play the work back, it is necessary 
to have a VoiceBox //connected to the computer. Thus 
anyone who wants to use your speaking or singing pro- 
gram would also have to have the synthesizer. 

Documentation: An eighteen page manual is supplied. 
This is sufficient to use the program but it could be more 
informative. New computer owners would have a difficult 
time at first. 

Skill level required: Intermediate computer user. 

Reviewer: Richard E. Devore 



Product Name: Mail List 

Equip, req'd: Atari 400/800/ 1200XL with 48K Atari 

BASIC disk drive printer 
Price: $39.95 

Manufacturer: MMG Micro Software 

P.O. Box 131 

Marlboro, NJ 07746 

Description: Mail List program. This program will handle 
up to 600 names per disk. It uses one complete sector per 
record and allows up to 125 characters per record. Each 
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record may contain separate entries for "First Name",, 
"Last Name", "Address 1", "Address 2", "City", 
"State", "Zip Code", "Reference 1", and "Reference 2". 
Features a random access search which claims to find any 
file on the disk in less than 1 second. Supports use of up to 
4 disk drives and multiple files on the same or different 
data disks. 

Pluses: Menu driven and easy to use. Sorts on "Name 2", 
"City", "State", "Zip Code", "Reference 1" in ascending 
or descending order. Prints labels with or without the two 
reference fields. 

Minuses: You MUST read the directions carefully and be 
sure to use OPTION 7-END to end the session or your 
records may be lost. 

Documentation: A twelve page booklet gives adequate in- 
stmctions for the programs use. 

Skill level required: Any computer owner with the prere- 
quisite equipment. 



Reviewer: Richard E. Devore 
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C64-FORTH 

for the Commodore 64 

FORTH SOFTWARE FOR THE COMMODORE 64 

C64-FORTH (TM) for the Commodore 64 - $99.95 

• Fig Forth-79 implementation with extensions 

• Full feature screen editor and macro assembler 

• Trace feature for easy debugging 

• 320x200, 2 color bit mapped graphics 

• 16 color sprite and character graphics 

• Compatible with VIC peripherals including disks, data set, modem, 
printer and cartridges 

• Extensive 144 page manual with examples and application screens 

• "SAVETURNKEY" normally allows application program distribution 
without licensing or royalties 

C64-XTEND (TM) FORTH Extension for C64-FORTH - $59.95 
(Requires original C64-FORTH copy) 

• Fully compatible floating point package including arithmetic, 
relational, logical and transcendental functions 

• Floating point range of lE+38 to 2E-39 

• String extensions including LEFT$, RIGHTS, and MIDJ 

• BCD functions for 10 digit numbers including multiply, divide, and 
percentage. BCD numbers may by used for DOLLAR.CENTS 
calculations without the round-off error inherent in BASIC real 
numbers. 

• Special words are provided for inputting and outputting 
DOLLAR.CENTS values 

• Detailed manual with examples and applications screens 

(Commodore 64 is a trademark of Commodore) 

TO ORDER- Specify disk or cassette version 

- Check, money order, bank card, COD's add $1.50 

- Add $4.00 postage and handling in USA and Canada 

- Mass. orders add 5% sales tax 

- Foreign orders add 20% shipping and handling 

- Dealer inquiries welcome 

PERFORMANCE MICRO PRODUCTS 



770 Dedham Street. S-2 

Canton, MA 02021 

(617) 828K209 
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CoCo To 
Smartmodem 
By John Kelty 

The Radio Shack Color Computer 
is certainly my favorite person- 
nel computer, but the RS-232 
connections are not exactly what I had 
in mind when I read that it had a serial 
interface (how many other RS-232 in- 
terfaces do you know of that use the 
data input line as the printer busy?). In 
any case, there are ways around these 
things, and to connect the Hayes Smart 
Modem to the CoCo, I have written 
this BASIC program (including a few 
POKES) to change the RS-232 input/ 
status line response. With this change, 
the many automatic features of this 
fantastic modem can be programmed 
from Color Computer BASIC. 

I am presently using a "64K" CoCo 
with Extended Disk Color BASIC, two 
disks, and the "Solution" [from Frank 
Hogg Labs). Since the program is fairly 
simple, I am sure it can be modified for 
whatever CoCo configuration you 
have. Most of the lines that are op- 
tional are listed as comments. 

The interface cable is made with a 
DIN plug at the CoCo end and a male 
DB-25P connector at the Smartmodem 
end. The pin connections are described 
early in the program listing. You need 



4-conductor cable and I have used as 
long as about 25 feet without any 
problems. It is convenient however, to 
have the Smartmodem near your com- 
puter setup, then you can hear the 
dialup and the send and receive carrier 
tones when you begin communicating. 
There are many programming options 
you can choose with the Hayes Smart- 
modem, and these are extremely well 
documented in the excellent Owner's 
Manual. (In case you have not guessed, 
I consider the Hayes Smartmodem my 
best computing purchase to date!). 

The BASIC program is menu driven 
for ease of operation. If you BREAK and 
then RUN the program again, the 
Smartmodem functions are cleared 
("AT Z" is sent to the modem). To 
write to the Hayes simply make the 
CoCo printer busy signal constantly 
high. I do this with software (remember 
that the modem is sending back infor- 
mation on that line as the data to 
CoCo) by programming the internal 
6821 bit to be an output. Not to worry! 
Remember somebody said that you 
cannot type in anything into your Col- 
or Computer that will damage it (See 
some past Rainbow editorials). This 
programming is accomplished with the 
following: 

A65314: BA1 

POKE B,51: POKE A,1: POKE B,55: 

POKE A,4 



Now you can talk to your modem just 
like it was a printer with PRINT-2, 
' 'your modem command' ' . 

To get back into the CoCo original 
RS-232 mode, use the following: 

(using same A and B as above) 

POKE 8,1: POKE A,0: POKE 8,55: 

POKE A,5 

Now you can use a communications 
package such as the Radio Shack 
Videotex or a similar program (see 
MODCOMM elsewhere in the CoCo 
section) to communicate (the Videotex 
will set the data rate at 300 Baud as re- 
quired by the Hayes 300 model). 

I know little to nothing of amateur 
radio operations, but with these 
POKES, a few lines of BASIC, and 
possibly some hardware, the Hayes 
Smartmodem can be made to send 
morse code. Auxiliary relay contacts 
are provided in the modem to key the 
transmitter automatically. It cannot 
however, be made to directly receive 
morse code. Diagrams describing the 
modem to radio interface are found in 
the Smartmodem User Manual Appen- 
dix H. Obviously some nice commer- 
cial terminal packages exist for the 
CoCo, but this program has made me 
happy for some time now. With the 
Hayes Smartmodem and the Color 
Computer, I am sure you will also en- 
joy computer communications. 

JMCftO 



Listing 1 




\9 'S«AfiT3«« 


340 'FROM HAYES FDR DETAILS, 


29 'KELTY EN6INEERIN6 


350 ' 


3« 'HRITTEN BY JOHN R. KELTY 


360 'tttttUtttttttttttttttttttt 


« 'LINCOLN, NEBRASKA 6fl5«5 


370 ' 


58' 


380 'RESET PRINTER BUSY TO WRITE TO HAYES 


bd 'USE THIS PROGRAM TD CONNECT 


390 ' 


78 'AND PROGRAM THE HAYES 


400 A=65314:B=A+1:POKE150,!B0 

410 POKEB, 51 : POKEA. 1 : PDKEB, 55: POKEA, 4 

420 DIM Mt(5),SN$(9) 


80 'SNARTNODEH TO THE RADIO 


90 'SHACK COLOR COMPUTER. 


m ' 


438 'tttttttttttttttttttUtttttt 


110 'THE CONNECTOR CABLE SHOULD 


440 'FOR CASSETTE OPERATION, YOU 
458 'CAN DELETE THE DISK CHECK, 


m 'CONNECT TO THE RS-232 PORT 


130 'IN THE FOLLOWING NAY: 


460 'BUT IT COULD BE LEFT IN, 


140 ' 


478 'WITH OR WITHOUT DISKS. 


150 'COLOR DIN HAYES CONNECTER 


480 'ututtutttttttttutttttn 


lt>0 ' 


498 DK=0:' CASSETTE OPTION 


170 ' 1 CARRIER DETECT 8 


500 IF PEEK(49152}=68 AND PEEK(4?153)=75 THEN DKM 


1S0 ' 2 RECEIVED DATA 3 


505 'CHECK FOR RS DISK ROM 


190 ' 3 SI6NAL GROUND 7 


510 CLS:PRINT:PRINT'- ttttt SMART MODEM ttttf 


200 ' 4 TRANSMITTED DATA 2 


528 PRINT- BY: KELTY ENGINEERING" 


210 ' 


538 PRINT' MttttMtttUtllttUttr 


220 'THE 300 BAUD HAYES MODEM 


548 PRINT: PRINT'CONNECT CABLES TO MODEM," 


230 'MAY BE USED NITH VIDEOTEK 


545 PRINT-COMPUTER AND PHONE COMPANY." 


240 'OR ANY OTHER TERMINAL 


558 PRINT:PRINT: PRINT" <BREAK AND LIST THIS PROGRAM TO' 


250 'PACKAGE THAT ALLOWS THE 


555 PRINT'SEE CABLE DETAILS)." 


260 'HAYES TO RUN AT 300 BAUD, 


568 PRINT:PRINT: INPUT-PRESS ENTER WHEN READY";A$ 


270 ' 


578 CLSiPRINT 


280 'THE HAYES HILL OPERATE 


588 PRINTi-2,"AT Z": 'CLEAR MODEM 

598 'ttmniuuttuttttuiutt 


290 'LOCALLY AT HIGHER RATES 


300 'BUT NO HIGHER THAN 300 


680 'MENU 


310 'WHILE ON LINE, 


610 M$(1)="AUT0 DIALING" 


320 ' 


620 M$(2)='AUT0 ANSWERING" 


330 'SEE YOUR USER'S MANUAL 


638 FOR S=l TO 2 
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Ma PRINTS;M$(S) 


1360 AN$(1)='00 NOT ANSWER" 


650 NEIT 5 


1390 AN«(2)="ANSHER IMMEDIATELY' 


bki PRINT:PRINT:PRINT"SELECT ONE OF THE ABOVE' 


1400 ANt(3)='ANSNER AFTER XX RINGS' 


i70 A$=INKEY«;IF A«="THENA70 


1410 FOR SA=1 TO 3 


680 ON VAL(AI) 60SUB 700,1310 


1420 PRINTSA;ANt(SA) 


690 60T0 510 


1430 NEXT SA 


700 ttttttttttttttttttttttttttt 


1440 PRINT:PRI»TsPRINT"SELECT ONE OF THE ABOVE' 


710 'AUTO DIALIN6 ROUTINE 


1450 A«=INKEY«:IF At="THEN 1450 


720 ttttttttttttttttttttttttttt 


1460 CLS:PRINT:PRINT' 'M«(2) 


730 ' 


1470 ON VAL(At) GOSUB 1490,1560,1720 


740 CLS:PRINT:PRINTI1«(1) 


1460 GOTO 1310 


750 PRINT:PRINT:PRINTM DIAL A SAVED NUNBER" 


1490 tttttttttttttttttttttttttt 


760 PRINT'2 DIAL A NEH NUMBER' 


1500 'DO NOT ANSWER 


770 A«=INKEY«:IFA«="THEN770 


1510 PRINT:PRINT' ttt"AN«(l)"ttf 


780 ONVAL(At) 6010800,980 


1520 PRINT:PRINT"THE SMART MODEM ANSHER FUNCTION" 


790 6OTO740 


1530 PRINT-IS DISABLED." 


800 ttttttttttttttttttttttt 


1540 PRINTi-2,"AT S0=0" 


810 HI1=2:'H0« MANY NUMBERS 


1550 GOTO 2040 


820 'TO CHANGE THIS LIST, HAKE HN=HOH NANY t YOU HANT TO 


1560 ttttttttttttttttttttttttt 


LIST (MAI OF 9). 


1570 'ANSWER IMMEDIATELY 


830 'THEN INSERT LINES SIMILAR TO THOSE BELON WITH YOUR 


1560 PRINT" ttt"AN«(2)"ttt" 


NUNBERS AND NAMES. 


1590 PRINT'THE SMART MODEM WILL ANSHER ALL" 


840 CLS: PRINT 'NUMBERS YOU CAN EASILY CALL': PRINT 


1600 PRINT-CALLS IMMEDIATELY." 


850 SN«(l)='l Xn-nU A FRIEND " 


1610 PRINT"USE THIS TO TRANSFER CALLS THAT" 


860 SN«(2)='2 m-m-XXU A BBS ' 


1620 PRINT"ARE ALREADY IN PROGRESS BETHEEN" 


870 FOR K=l TO HM 


1630 PRINT'THO INDIVIDUALS TO COMMUNICATION" 


880 PRINT SNt(K) 


1640 PRINT"BETHEEN THEIR COMPUTERS." 


890 NEH 


1650 GOSUB 1870 


900 PRINT:PRINT'SELECT ONE OF THE ABOVE" 


1660 PRI»Ti-2,"AT"DP«"A" 


910 PRINT' (BREAK AND LIST TO EDIT THESE NUMBERS).' 


1670 PRINT"AT THIS POINT YOU NEED TO RUN" 


920 A«=INKEY«!lF A«="THEN920 


1680 PRINT'OR EXEC YOUR OHN RECEIVER" 


930 NB=VhL(A«) 


1690 PRINT"PROGRAM TO INTERPRET THE" 


940 IF NB<1 OR NB:>HN THEN 800 


1700 PR1NT"INC0MINGCALL." 


950 P$=niDt(SNt(NB),5,i6) 


1710 GOTO2040 


960 6OSUB1090 


1720 tttttttttttttttttttt 


970 RETURN 


1730 'ANSWER AFTER XX RINGS 


980 tttttttttttttttttttttttttt 


1740 PRINT:PRINT" ttt"AN«l3)"ttt" 


990 PRINT:PftINT'DIALIN8 A NEU NUMBER' 


1750 PRINT: PRINT'THE SMART MODEM WILL ANSWER ALL" 


1000 PRINT:PRINT'TYPE IN THE PHONE NUMBER THAT' 


1760 PRINT"CALLS AFTER THE NUMBER OF RINGS' 


1005 PRINT'YOU WISH TO CALL.' 


1770 PRINT"YOU SELECT (FROM 1 TO 255 RINGS)" 


1010 PRINT'EXAMPLES:" 


1780 PRINT 


1020 PRiNT'i-800-nx-nn long distance 


1790 INPUT"HDW MANY RINGS (1 TD 255)";RG 


1030 PRINT' 112-B00-Xn-XXXX FROM LINCOLN 


1800 RG=I»TIRG) 


1040 PRINT'Xn-nXX LOCAL CALL 


1810 IF RG<1 OR R6>255 THEN 1790 


1050 PRINT 


1820 PRINT:PRINT"THE PHONE WILL BE ANSWERED" 


1060 LINE INPUT'TYPE DESIRED NUMBER' ;P« 


1830 PRINT"AFTER"RG"RINGS," 


1070 G0SU6 1090 


1840 GOSUB 1870 


1080 RETURN 


1850 PRINTI-2 •AT"DP«"S0="RG 
I860 PRINT:GOTO 1670 


1090 tttttttttttttttttttttttttt 


1100 'NUMBER KNOHN AT THIS POINT 


1870 ttttttttttttttttttttttttt 


1110 'READY TD DIAL 


1880 'FULL OR HALF DUPLEX 


1120 PRINT|-2,"AT F0 D"P$ 
1130 'ENABLE RS232 RECEIVE BIT 


1890 PRINT:PRINT'DO YOU WANT FULL OR HALF DUPLEX?" 


1900 PRINT" IIF YOU DO NOT KNOW, TRY HALF)." 


1140 POKEB,1:POKEA,0:POKEB,55:POKEA,5 


1910 PRINT:PRINT"1 FULL DUPLEX" 


1145 STOP 


1920 PRINT"2 HALF DUPLEX" 


1150 IF DK=0 THEN 1230 


1930 A*=IHKEY«:IF A«="'THEN1930 


1160 'tttttttttttttttttttttttttt 


1940 ON VAL(A«) GOTO 1950,1990 


1170 'YOU CAN LOADM ANY TERMINAL 


1950 'FULL DUPLEX 


1180 'PACKAGE THAT YOU HISH BY 


I960 DP«="F1" 


1190 'EDITING THE NEXT LINES. 


1970 PRINT: PR1NT"FULL DUPLEX SELECTED." 


1200 LOADM 'MODCOMM' 


1980 GOTO 2020 


1210 FOR D=l TO 2000:NEn D:'DISK MOTOR DELAY 


1990 'HALF DUPLEX 


1220 'EXEC 


2000 DP*="F0" 


1230 CLS:PRINT:PRINT'YOU NEED TO USE YOUR ONN" 


2010 PRIHT:PRINT"HALF DUPLEX SELECTED. ' 


1240 PRINT'TERMINAL PACKAGE AT THIS POINT' 


2020 PRINT 


1250 PRINT' (SUCH AS VIDEOTEX AND OTHERS).' 


2030 RETURN 


1260 PRINT'IF YOU HAD PRELOADED A TERMINAL' 


2040 'ttttttttttttttttttttttttt 


1270 PRINT'PACKAGE WRITTEN IN MACHINE" 


2050 'EXIT ROUTINE 


1280 PRINT'LANGUAGE, THEN SIMPLY TYPE EXEC 
1290 PRINT'AND PRESS ENTER.' 


2060 'ENABLE RS232 RECEIVE BIT 


2070 POKEB,1:POKEA,0:POKEB,55:POKEA,5 


1300 GOTO 2040 


2080 PRINT:PRINT"THIS PROGRAM HAS ENDED." 


1310 'tttttttttttttttttttt 


2090 EXEC 


1320 'AUTO ANSWER ROUTINE 


2100 'TO USE THIS PROGRAM WITH MODCOMM 


1330 'tttttttttttttttttttt 


2110 'YOU MUST ADD A SWITCH TO THE MODEM 


1340 ' 


2120 'CABLE SO THAT PIN 1 CAN BE CONNECTED 


1350 CLS:PRINT:PRINTM$(2) 


2130 'TO PIN 2 AFTER DIALING THE NUMBER 


1360 PRINT 


2140 'SEE MODCOMM ARTICLE FOR EXPLAINATION Mireo" 


1370 'MENU 


2150 END '"'^~ 
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reason or timing will be wrong and data 
will probably be lost. 

The hardware configuration of the 
RS-232C I/O port is as follows: 



MODCOMM 



The Color Computer 

and Modem to Modem 
Communication 



MODCOMM explains how to use the Color Computer to 
communicate to large mainframe computers. The 
program has the Color Computer emulating a 
dumb terminal. 



by Walter Charlton 



Modem to modem communica- 
tion is often a necessary use of 
the Color Computer. Radio 
Shack has a ROM pack that will make 
the Color Computer emulate a dumb 
terminal; however, since the package is 
in ROM, there is no way to add other 
applications or features to the package. 
The purpose of this paper is to show 
how simple it is to write your own ap- 
plications. Additionally, there is a pro- 
gram with this paper that wUl do most 
things the Radio Shack package will. 
The paper also shows the use and ad- 
vantages of interrupts. 

The program listed here is com- 
pletely relocatable, so for those CoCo 
owners that only have 4K of memory, 
you can load the object code begitming 
at any location and it will work. The 
source code in the listing will take at 
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least 16K of memory, if you use an 
assembler package. 

The CoCo use the Peripheral Inter- 
face Adapter (PIA) to communicate to 
external devices. While the PIA is an 
excellent device, it was actually de- 
signed for parallel communication. 
When it is used for serial communica- 
tion (for instance with the RS-232Ci, 
the information must be passed to the 
adapter one bit at a time. Timing loops 
must be designed to wait the proper bit 
time for baud rate timing. 

There is also a drawback in the soft- 
ware. The processor must be totally 
dedicated to input or output at the time 
of communication, so a great deal of 
processing time is wasted. For in- 
stance, if the processor is bringing in 
information from the RS-232C I/O 
port, it cannot be interrupted for any 
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Pin 


Purpose 


1 


Carrier detect - 




CAl Interrupt of 




PIAl 


2 


Data in - Bit of 




Address &HFF22 




on PIAl 


3 


Ground 


4 


Data out - Bit 1 of 




Address &HFF20 




on PIAl 



As the interrupt is currently wired 
[pin 1), it is useless for modem com- 
munication. The carrier detect just 
checks for carrier on the modem. If 
carrier exists, the interrupt is active 
(carrier is the medium that actually 
transmits the data over the phone 
lines). This would mean that com- 
munication must be totally software 
controlled. Better use of this interrupt 
would enhance the computers ability 
to communicate to a mainframe. 

An interrupt can be used to force the 
MPU to a service routine. For instance, 
the computer can be busy doing 
anything and still be programmmed so 
that when an interrupt occurs, it will 
drop what it is doing and go to a vector 
address that will service the interrupt. 
After servicing the interrupt, it can 
then return to exactly what it was do- 
ing before the interrupt. Since data 
coming onto the computer will always 
be at random intervals, I wanted to use 
the interrupt line to bring in the data. I 
did this simply by tietng the data in 
line to the interrupt so that when a bit 
enters the computer, it will force an in- 
terrupt. This is a very simple technique. 

I suggest that you first purchase a 
new serial I/O cable from Radio Shack. 
This cable should be used only for 
modem to modem communication. 
Select one end and lift a small tab out of 
its slot which will allow you to pull 
back the outer shield. The inner shield 
can now be separated which will bare 
the wires. Cut the wire to pin 1 (the 
pins are numbered on the front) and 
solder a small piece of wire from pin 1 
to pin 2. After putting it all back 
together, mark the modified end. This 
end will be the one that plugs into the 
CoCo. We are now ready to start on the 
software. 
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Software 

Without the use of the interrupt, 
the data in line would need continual 
checking. The interrupt significantly 
reduces the software needed for com- 
munication. I will first discuss the out- 
put routine and then the input. Most of 
the programming of the PIA is done on 
power up of the computer so nothing 
more is needed on that. 

Lines 1700-1900 are the transmit 
routine. All that is needed to transmit 
is a store command to the address 
&.HFF20.The data is held in register A 
of the MPU as shown in the DATAOT 
subroutine. Bit is then shifted into 
the carry bit with the LSRA command. 
This is followed by two rotate left com- 
mands that position the bit into the 
transmit location of the B register. The 
B register is then stored into &JHFF20 
which transmits the data. After 
transmitting the entire byte, two stop 
bits are normally transmitted which 
are logic ones. Often one of the stop 
bits is not used. Also, some systems 
use parity, so Lf the program listed here 
does not work, check with your 
systems people to get what is needed. 

You should note the branch to the 
subroutine WAIT in DATAOT. This is 
the baud rate timer. This routine can be 
used for both transmit and receive, and 
is currently set for 300 baud. For 
reasons I will explain later, it cannot be 
set for a baud rate higher than 300 in 
the program listed here. 

The loop value for the baud rate 
timer is found by the following steps. 
First, find the cycle time of the CoCo 
by dividing the clock time j.895 MHz) 
into one. Second, find the baud rate 
time by dividing the baud rate |300 
baud) into one. Third, divide the com- 
puter cycle time into the baud rate time 
to find the number of cycles for each bit 
time. Finally, the wait loop takes ex- 
actly 8 cycles, so after taking you the 
overhead (about 10 cycles), divide the 
above value by eight and the answer is 
the time for one bit wait. This pro- 
cedure works for any baud rate. 

Before discussing the receive 
technique, I will talk about how to set 
up the interrupt routine. Lines 640-720 
show the routine that prepares the 
computer for interrupts. Bit is forced 
high in address &HFF21. This is the 
control address for the A side of PIAl. 
By forcing the bit zero high, the inter- 
rupt is activated when CAl is 
No. 68 - January 1984 



forced low by the peripheral. The FIRQ 
interrupt is tied to the PIA so the jump 
vector address is in &.H110 and 
SlHIII. These addresses are loaded 
with the start address of the subroutine 
DATAIN which is the service routine 
for the interrupt. The final job of the 
initializing routine is to able the inter- 
rupt in the condition code register so 
that the interrupt will be recognized by 
the MPU. When an interrupt occurs, 
the MPU will go to addresses &H110 
and &.H111 to get the service routine 
address and will then execute it. After 
executing the service routine, and RTI 
command will return the processor to 
the point before the interrupt. 

Subroutine DATAIN (lines 
1230-1610) works just the reverse of 
subroutine DATAOT. The first thing 
that needs to be done when entering 
the subroutine is mask any interrupts. 
If this is not done, the computer will 
start interrupting interrupts as data 
comes into the computer. Another 
thing that needs to be done upon enter- 
ing the routine is to save the state of all 
registers. The FIRQ interrupt will only 
save the program count and condition 
code register, so the rest of the registers 
must be saved to assure that nothing 
will be lost when returning. 

The HBWATT routine is a half bit 
wait. It is necessary to center the recep- 
tion so that slight errors in the timing 
will not matter.. Address &HFF22 is 
the data address for receive. The data is 
in bit and after a load of the data 
register, two rotate commands are 
needed to position the data in the A 
register. The RORB moves the data into 
the carry bit and the second shifts the 
data into the A register. Since the inter- 
rupt is the CAl, it is necessary to read 
the PIA data register A (&HFF20) to 
clear then interrupt. This should be 
done just before returning. 

A further comment needs to be 
made on interrupts if using a program 
pack for assembly. The program pack 
forces a continual interrupt that cannot 
be cleared. If this is not disabled, the 
program cannot be executed with the 
pack installed because the interrupt 
will always be active. The simplest 
way to disable the interrupt is by put- 
ting scotch tape over pins 7 and 8 of the 
program pack. These pins can be found 
by viewing the pack from the top. Hold 
it with the plug at the top and points 7 
and 8 are the first ones on the top and 
bottom with copper runs from the right 
side. You can tell if you have the proper 
end because just next to pin 7 is the 5 
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volt pin which is slightly indented. 
After installing the program pack, it 
can be executed by typing EXEC 49152. 

The Program 

The program has a few features that 
have not yet been mentioned. It will 
output nearly the full spectrum of con- 
trol characters. The downward arrow 
acts as the control key. It has a 
backspace key that when used with the 
shift key, will output the delete /rub 
character. Both lower and upper case 
characters are recognized, displayed 
and output (lower case letters have a 
dark background). By using the shift 
and clear keys, the program will be 
exited. Without the shift key, the clear 
key outputs the escape character. The 
break key will output the control C 
character. Shift zero will set the 
keyboard to lower case characters and 
output upper case only when the shift 
key is used. 

This program does have a few 
weaknesses. The program cannot send 
and receive data at the same time. This 
would take a great deal of software and 
has little value so I did not put it in. I 
did, however, mask the interrupts go- 
ing into the data out routine. This will 
allow the operator to transmit data 
even if a long receive message is com- 
ing in. One or two characters may be 
lost, however, on receive. 

There will be some difficulty in in- 
creasing the baud rate on this program. 
Screen control and scrolling are done 
during the two stop bit times. Since 
screen control takes a great deal of 
time, any increase in the baud rate will 
result in garbage on there screen during 
scroll. As it was, I had to reduce the 
half bit wait to get the screen control 
in. If it is necessary to communicate at 
a higher baud rate, the received infor- 
mation will have to be buffered and 
displayed when the processor has 
more time. 

The program, as listed here, is just 
one use of the Color Computer' s ability 
to communicate to mainframe. Other 
uses could be for preloaded programs 
for later transmissions, downloading 
from a computer or use as an intelligent 
terminal. Happy computing! ijfVICftO 



Walter Charlton has his MBA from the 
University of Nevada, Las Vegas. He 
teaches computer programmmg part time 
and works as a Field Engineer for a major 
computer manufacturing firm. 
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A VOX Input 

For Your 

Color Computer 



A discussion of subroutines tiiat aliow sound as a form 
of input. 



All Sound Subroutines 

require: 

TRS-80 Color Computer with 
cassette. Some routines 
require Extended BASIC. 



By Sean !\/loyer 



While waiting for a particularly 
long program to cassette load 
during one of my late night 
programming sessions, I began to 
ponder the possibility of voice control 
for my Color Computer. Visions of ex- 
ternal amplifiers and analog to digital 
converters danced through my mind. 
Next to dance through my mind were 
visions of the price tags that accom- 
panied these pieces of equipment. I was 
about to abandon this line of thought 
when my attention was caught by the 
steady hiss of the program loading in. It 
dawned on me that I probably had 
everything I needed right in front of 
me. I realized that in order for a pro- 
gram to load in from the cassette 
player, the input from the player had to 
affect any number of memory locations 
in the area of memory devoted to I/O. 
All I needed was a source of sound for 
the cassette player and a program to 
look through the area of memory 
devoted to I/O. I found the range of 
memory addresses devoted to I/O in 
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the Color Computers Owner's Manual. 
I developed the program in listing 1 to 
look through each address, pausing 
momentarily at each one. 

For noise, I grabbed the nearest 
music cassette I had on hand, put it in 
the Color Computer's cassette recorder 
and pressed play. I ran my program, sat 
back and waited. My wait was a short 
one. At memory location 65312, I 
noticed the content display flickering 
rapidly. I recorded the location, and 
letting the program run, I found several 
more locations showing identical 
behavior. The change on the display 
was binary two for the low state, three 
for the high. 

All that remained now, was to 
substitute my voice for the prerecorded 
input. The procedure for accomplishing 
this varies, depending on the type of 
cassette you own. For the older black 
model, with built in microphone, 
simply remove the plug from the 
"MIC" jack on the left side of the unit. 
Next, open the cassette compartment 
and remove the cassette. Now, care- 
fully inspect the upper lefthand comer 
of the compartment. There will be a 
small stud there. Push the stud toward 
the back of the unit. While holding it 
down, press Record and Play. 

The process is the same for the 
more recent models with one excep- 
tion. You must plug an external 
microphone into the "MIC" jack. With 
this accomplished, the recorder is 
now sending your amplified voice to 
the computer. 
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To test the procedure, turn up the 
volume on your monitor and type 
AUDIO ON. If the procedure was com- 
pleted correctly, you should hear your 
amplified voice issuing from your 
television speaker. With the 
preliminary set up now complete, we 
are ready to discuss three subroutines 
that should get you sufficiently 
familiar with the basics of sound input 
to help you to develop your own sound 
subroutines. 

The first subroutine is a voice ac- 
tivated binary input. When the pro- 
gram receives a sound, the routine is 
turned "ON". When the next sound is 
recognized, the routine is turned 
"OFF", and will alternate "ON" and 
"OFF" with each additional sound. 

Specifically, the program will check 
memory location 65312, If this loca- 
tion contains a 2, the low state, it 
returns and checks again. If the loca- 
tion contains a 3, indicating the 
presence of sound, the program im- 
mediately prints ON. The next se- 
quence in the routine is a FOR/NEXT 
loop. This delay loop debounces the 
switch, which is to say it allows the 
sound that activated the switch to end. 
Without this delay the voicing of a 
word such as ON or OFF would be suf- 
ficiently long as to turn the routine off 
and on several times in succession. The 
memory location is checked again in 
the manner previosly mentioned, and 
when a sound is recognized, the pro- 
gram prints OFF and goes through a de- 
bouncing loop. The program returns to 
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the beginning and repeates the cycle. 

If the program fails to operate and 
you determine it has been entered cor- 
rectly, reset the computer. Under 
special circumstances, such as the use 
of the AUDIO ON or PLAY commands, 
the contents of memory location 65312 
may be other than 2 or 3. If the program 
gets number other than 2 or 3, it will 
crash. Resetting the computer should 
restore the program to operational order. 

This is the least complex and least 
useful of the three routines presented 
here. It serves basically as a primer for 
the next two programs. The next two 
routines are more complex, and they 
should prove more interesting and 
useful as well. 

The next routine we will discuss is 
the voice operated dictation shown in 
listing 3. This program is designed to 
record whatever you say, deleting the 
long periods of silence between 
phrases. To run this program, leave a 
blank cassette in the recorder before 
you press record and play. 

The program begins by checking 
memory location 65312. When a sound 
is recognized, the recorder is activated 
by the MOTOR ON command. The 
delay loop that follows serves a 
somewhat different purpose than that 
in the VOX binary input. This loop 
prevents the recorder from shutting 
down during the short pauses between 
words in a sentence, or even shorter 
silences in the words themselves. The 
program begins the count from 1 to 
300, and checks memory location 
65312 inside the loop. If at any time a 
sound is recognized, the program 
begins the count again from 1. This 
way, if the pause is short, the loop re- 
initiates, leaving the motor on. If the 
pause is long, the routine will complete 
the loop, and the recorder will be shut 
down using the MOTOR OFF command. 
Finally, the program returns to the begin- 
ning and waits for the next sound. 

If this program is used for dictation 
a small preliminary sound, such as a 
finger snap, might prove necessary for 
total legibility. When the first sound is 
sensed the motor is activated, but it 
takes a fraction of a second for the 
motor to reach proper recording speed. 
This often causes the first word to be 
lost. A finger snap would activate the 
motor and allow it to reach recording 
speed in time for the first word to be 
recorded. A preliminary sound would 
not be needed if the program were used, 
for instance, to monitor an empty room 
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for activity. 

The third and final program differs 
from the first two in that instead of a 
straight binary input, it uses a sampling 
routine to approximate an analog in- 
put. This program displays the analog 
approximation in PMODE 4 graphics, 
oscilliscope style. This is the only 
routine that requires Extended BASIC. 
In addition, because the program uses a 
real time graphics display, I have in- 
cluded the high speed poke [POKE 
65495,0). If the high speed poke does 
not work on your system simply 
remove it from the program. This will 
slow down the routine, though the 
results should still be acceptable. 

The routine begins with the high 
speed poke and then prepares the 
graphics screen. This is followed by a 
threesome of nested FOR/NEXT loops. 
The outer loop controls the initial ver- 
tical placement of each trace line. The 
next loop in controls the rate at which 
the trace sweeps horizontaly across the 
screen. The innermost loop is the heart 
of the program. This is the sampling 
routine. For every point on the horizon- 
tal sweep, memory location 65312 is 
sampled six times. 

The routine sums all six samples, 
and stores the sum in variable T. It 
then subtracts a constant (12 in this 
case), so that six samples taken during 
a period of total silence would give T a 
value of zero. T is then multiplied by a 
constant (4) to give the graphic dis- 
play proper amplitude. The grahics dis- 
play comes directly after the sampl- 
ing routine. 

These routines will help you under- 
stand the workings of the cassette audio 
input port, and hopefully they will be 
useful to you in your program library. 



You may contact Sean Moyer at, 1825 
South 1 7th Street, Fargo, ND 51830. 



Listing 1 

10 fiE« PR06RA?I 1 

20 REM ilERQRY SEARCH 

30 REM BY SEAN dOVER 

40 CLS 

50 REfi I IS ADDRESS RANSE 

60 FOR I = 652B0 TO 65535 

70 REM J IS i OF TINES EACH 

80 RE.1 ADDRESS IS DISPLAYED 

90 FOR J = 1 TO 75 

100 REM DISPlfiYS ADDRESS AND 

no REfl CONTENT CENTER SCREEN 

120 PRINTI224,I,PEEX(I1 

130 NE^T J 

140 NEH I 



Listing 2 



10 RE« LISTING 2 

20 REI1 VO,^ BINARY INPUT 

30 RE?I BY SEAN HOYER 

40 REfl 

50 .REf! CHECKS FOR SOUND 

60 IF PEEK (65312) = 3 THEK 70 ELSE 60 

70 PRINT'ON" 

30 REfl DELAY LOOP 

90 REN DEBOUNCES SWITCH 

100 FOR I = 1 TO 20G : NEH I 

110 REM CHECKS FOR SOUND 

120 IF PEEK (65312) = 3 THEN 130 ELSE 120 

130 PRINT"OFF" 

140 REfl DEBOUNCES SWITCH 

150 FOR ! = 1 TO 200 ; NE)!! I 

160 GOTO 60 



Listing 3 

10 REfl LISTING 3 

20 REfl VOX DICTATION 

30 REfl BY SEAN I10YER 

40 REM 

50 REfl CHECKS FOR SOUND 

60 IF PEEK (65312) = 3 THEN BO ELSE 60 

70 REfl ACTIVATES RECORDER 

SO flOTOR ON 

90 REM DELAY LOOP /CONTINUITY 

100 FOR I = 1 TO 300 

110 REfl IF DICTATION IN PROCESS 

120 REfl REINITIATES DELAY LOOP 

130 IF PEEK !6.5312) = 3 THEN 100 

140 NE.KT 1 

150 REM DEACTIVATES RECORDER 

160 MOTOR OFF 

170 GOTO 50 



Listing 4 

10 REfl LISTING 4 

20 REfl OSCILLISCOPE 

30 REfl BY SEAN MOYER 

40 REfl 

50 REM HIBH SPEED POKE MAY NOT 

60 REM WORK ON SOME SYSTEMS 

70 REfl REMOVE IF INOPERABLE 

80 POKE 65495.0 

?C REM PREPARE GRAPHICS SCREEN 

100 PflODE 4.1 

110 SCREEN 1.1 

120 PCLS 

130 REM VERTICAL PLACEMENT LOOP 

140 FOR y = 26 TO 191 STEP 25 

150 REfl HORIZONTAL SWEEP 

160 FOR H = 4 TO 255 STEP 4 

170 REM SAflPLiNG ROUTINE 

130 T=0 

190 FOR I = 1 TO 6 

200 T = T + PEEK (65312) 

210 NEH ! 

220 REfl CORRECTION FDR 

230 REfl ZEROING AND AMPLITUDE 

250 REM GRAPHICS DISPLAY 

260 LINE (H-4, V-TDJ-(H, V-T),PSET 

270 TD=T 

280 NEN H 

290 NEH V 



3.00 GOTO 50 
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CoCo Bits 



Last month we looked at how easy 
it is to install drives on the CoCo. 
This month, lets take a look at 
something new that you may be in- 
terested in running with your new disk 
drives. The OS-9 operating system has 
finally been released, and is now 
available in local Radio Shack stores. 
OS-9 is one of the most powerful disk 
operating systems I have seen, and pro- 
vides new power for CoCo, and new 
capabilities. In addition to OS-9, Radio 
Shack is selling BASIC-09, a very power- 
ful, supplement to Extended BASIC. 

The OS-9 package, which retails for 
$69.95, comes in a gray box, and con- 
tains four operating manuals. Getting 
Started Wi± OS-9; OS-9 Commands; 
OS-9 Program Development; and OS-9 
Technical Infonnation. OS-9 requires a 
64K CoCo and at least one disk drive. 
See the July and August, 1983 CoCo 
Bits for instructions on upgrading your 
machine to 64K. There are two disks 
included in the package, an OS-9 Boot 
disk, and an OS-9 system master. The 
OS-9 boot disk allows users with 1.0 
disk disk ROMs to boot OS-9. CoCo 
users with 1 . 1 disk ROM may just load 
the system master and type 'DOS'. The 
new DOS command will take care of 
selecting 64K mode and other details. 

The boot disk has one other utility 
of value to all CoCo disk users, a disk 
timing utility. This program reads and 
displays the RPM of the selected drive. 
The Getting Started... manual lists 
accepted speeds, however an addendum 
letter corrects those speeds to a range of 
acceptable RPM from 295.5 to 304.5 
RPM. If your drive is out of time. Radio 
Shack recommends you send it in to be 
adjusted, however the TEC drive in- 
cluded with the RS disk system is easy 
to adjust yourself. 

All you have to do is shut off the 
computer, unplug the drive from the 
AC outlet, remove the screws holding 
the case and lift the case off. On the left 
side of the drive (facing front), you will 
find the motor drive belt and pulleys. 
Just below these, there is a small cir- 
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by John Steiner 

cuit board with a small adjustment 
potentiometer. Plug in the drive unit, 
install and run the disk timing program 
and adjust the potentiometer with a 
small screwdriver until the drive speed 
is within range. When done, turn off 
the computer, unplug the drive and 
reinstall the case. 

Now that we are done with that 
little diversion, back to OS-9. Other in- 
cluded utilities include an editor and 
assembler for writing your own OS-9 
software. For those who would like to 
know how the DOS interfaces with 
your CoCo, the operating system 
resides between any applications pro- 
grams and languages you may run, and 
the computer. All programs and 
languages are designed to use OS-9 to 
access the disk, printer, terminal, 
keyboard and video display. 

Who needs OS-9? Anyone who 
wants to run applications programs 
written using the operating system, 
and anyone who might be interested in 
running other languages besides 
BASIC. By the time you read this, you 
should be able to buy PASCAL, C, and 
COBOL configured to run on CoCo. If 
you write your own machine language 
software, you will like the thorough 
documentation of the operating 
system, and the ease with which you 
can implement and access disk files, 
and other CoCo accessories without 
having to write your own device drivers 
or trying to decipher the ROM. 

OS-9 is in charge of managing the 
disk directory, and keeping tabs on how 
the computer can manage its time and 
system resources, OS-9 creates one of 
the most sophisticated disk directories 
in the computer industry in that it 
allows directories within a directory. 
For example, you can make a directory 
of accounting files called ACCOUNTS, 
and within the directory you might 
have files called ledger, receivables, 
payables, etc. For that matter, you 
could have a sub directory in the 
ACCOUNTS directory that could have 
its own set of files. If you enter DIR at 

MICRO 



the OS-9 prompt, you will see a list of 
directories and files stored under the 
main operating system directory. 
Entering DIR /DO/ACCOUNTS will 
list all the files and sub directories 
stored in the ACCOUNTS directory. 
To keep files and directories separate, 
OS-9 users have developed the conven- 
tion of using upper case characters 
when naming characters and lower case 
characters when naming files. Eight 
letter filenames are a thing of the past 
and you are allowed from 1 to 29 
characters. 

The directory system builds files in 
a tree or hierarchical format and you 
move from directory to directory with 
the CHD (change data directory) or 
CHX (change execution directory) 
commands. CHD /DO/ ACCOUNTS 
will move you to the ACCOUNTS 
directory and all commands that con- 
tain any default options will default to 
the ACCOUNTS directory. The whole 
process is a lot easier to understand 
than explain, and the manuals have 
several examples that allow you to 
understand how to create and delete 
directories. 

In addition to the multiple level fil- 
ing system, OS-9 is multiuser and 
multitasking. In the Color Computer 
implementation, you can configure the 
RS-232 port as a terminal and someone 
can use the accounting package from a 
terminal while you are running 
customer files from the main CoCo 
keyboard. A security system can be im- 
plemented that allows users to have 
private and public files, and files can be 
read or write protected. You have the 
capacity of private passwords for up to 
65,535 users. Most of us don't even 
know that many people. 

Multitasking allows the user to run 
more than one task at a time. For exam- 
ple, you might ask OS-9 to list a file 
using the command LIST /Dl/customer 
/P &. LIST is a program that will 
display the output of a file on the video 
display. In this case, the file 
"customer". Options include /Dl for 
drive one, /P redirects output from 
the video display to the printer and the 
8k (ampersand) tells OS-9 to do this as a 
background task. This means that the 
prompt will return to the display, and 
keyboard control will be restored so 
that you may continue with other 
tasks. OS-9 will share time between 
the printing task you just gave it and 
any other tasks you decide to give it. 
The only limit to the number of tasks 
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you ask the computer to do at one time 
is the available memory space. 

The computer will share tasks in a 
priority basis, and you may assign a 
higher priority for jobs you want done 
more quickly. OS-9 uses a hardware 
clock to divide time into slices, and 
allot more time slices to tasks that 
have a higher priority. By the way, 
when you sign on to OS-9, you can 
enter the time and date, and the time 
will remain accurate, even with disk 
I/O as the software does not allow in- 
terruption of the time clock for disk 
I/O. You can use the clock in program 
output for any purpose desired. 

One of the major advantages of OS-9 
is its device independent I/O system. 
Only one I/O routine is needed with 
several drivers written to support the 
devices being used. OS-9 normally 
defaults to input from the keyboard and 
output to the video display, however it 
is easy to redirect input and output as 
required. Devices that are supported in 
the CoCo implementation are: 



Drives to 3 
Keyboard 
Video display 
Serial printer 
RS-232 terminal 
Joysticks 



As an example, you might redirect in- 
put from the keyboard to drive 1, and 
output from the display to the printer. 

OS-9 is powerful, and complex, and 
I have a big project to become proficient 
in its use during the cold North Dakota 
winter. This overview will hopefully 
give you some idea of the new found 
power in the Color Computer. You 
don't have to hang your head anymore 
when someone asks ' 'Why did you buy 
that "toy" computer. 

Over the next few months we will 
take other looks at OS-9 and its 
features. Next month we will look at 
BASIC09, and see what features and ad- 
vantages you get for your hundred 
dollars. We will also take a look at two 
more CoCo word processors. Nelson's 
VIP Writer, and Elite* Word. j)^|CftO 



You may contact John at 508 Fourth Ave., 
N.W., Riverside, ND 58078. 



SPECTRUM 

32K RAM Button $ 2.99 

NANOS Reference Card $ 3.99 

64K RAM Button $ 4.99 

Coco Editor Assembler $ 6.95 

Coco Tech Manual $ 7.95 

16K RAM Chips $ 9.95 

Coco Secrets Revealed Book.S 14.95 

LED On/Off Indicator $ 14.95 

Coco Light Pen $ 19.95 

ATARI Joystick Interface $ 19.95 

Video Interface Kit S 24.95 

16K-32K Upgrade Kit $ 25.95 

6883 SAM Chip $ 29.95 

6809E CPU Chip 4 29.95 

Basic ROM 1.1 4 36.00 

64K RAM Chips $ 49.95 

MARK DATA Keyboard $ 69.95 

BOTEK Printer Interface $ 69.95 

Extended Basic ROM $ 84.00 

Disk Controller. $139.95 

COLOR COMPUTERS $ CALL 

Call or Write for FREE Catalog 

SPECTRUM PROJECTS 

93-15 86th Dr Woodhaven, New York 11421 

Add Sales Tax & $3.00 for S/H 

## Dealer/Club Inquires Invited •# 

212 441-2807 



It pays to write for MICRO! 

D Win the esteem of your colleagues - 

D Gain recognition as a computerist - 

D See your programs and ideas in print - 

D Feel satisfaction from helping others - 

D Earn money for your work. 

MICRO wants to continue to provide substantial 
material for the Serious Computerist. This must come 
from you - the readers of MICRO who are actively 
invloved with understanding the inner workings of 
microcomputers, who experiment to find better ways of 
using microcomputers, who are developing new 
techniques, who are programming in assembler, 
FORTH, Pascal and other languages in addition to 
BASIC. 

Writing for MICRO is easier than you think. If you can 
provide the programs and the basic information about 
how they work, our staff can help turn this 'rough' 
material into a polished article. Remember, in this 
business, everyone knows something of value, and 
nobody knows everything. 

Request the Writer's Guide which covers many of the 
fundamentals of writing for MiCRO. 
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TRS-80C Reviews 




Product Name: Disk interface/ROM pack extender 

Equip, req'd: TRS-80 Color Computer Disk system 
Price: $29.95 + $3.00 shipping 

Manufacturer: Spectrum Projects 

93-15 86th Drive 

Woodhaven, NY 11421 

Description: The Spectmm Projects disk interface and ex- 
tender cable can be a useful accessory for the Color Com- 
puter. It allows the disk or program ROM pack to be 
located up to three feet away from the side of the com- 
puter. This high quality cable has a gold plated connector 
on each end that mates with the connectors on the com- 
puter and ROM packs. 

Pluses: Makes positioning of drives more convenient at 
the desk, allows the computer to have only a ribbon cable 
extending from the computer, rather than a large ROM pack. 

Minuses: Unfortunately, it may not work with all drives. 
My MPI works correctly with the cable but my Tandy unit 
has problems. If I put drive one as drive zero, then the 
cable seems to work. It is possible that my drive needs ad- 
justment for the longer length of cable. 

Documentation: None needed or provided. The cable is 
marked TOP on both sides, care must be taken that the 
cable is inserted correctly. 

Skill level required: The cable is easy to install by even 
a novice. 

Reviewer: John Steiner 



Product Name: The Stripper 



Equip, req'd: 

Price; 

Manufacturer: 



TRS-80 Color Computer 

$7.95 

Eigen Systems 

P.O. Box 10234 

Austin, TX 78766 



Description: The Stiipper is a programmers utility for the 
Color Computer that will compress or "pack" a BASIC 
program. Stripper has three options, remove remarks, pack 
lines, and remove spaces. Any one or all three options may 
be exercised. 

Pluses: The packed program will take up less memory, and 
may operate slightly faster. The utility normally loads into 
graphics memory, thus freeing all other memory for the 
packing operation, and youi BASIC piogiam. One of the 
lowest cost utilities I've seen, and well worth the money. 



Minuses: You cannot edit, or otherwise change a line 
packed program. The program must be saved in an un- 
packed format, should you decide to modify or edit it. 

Documentation: Four pages of notes describe the opera- 
tion of the program thoroughly. 

Skill level required: No advanced skill level is required to 
use the program. 

Reviewer: John Steiner 



Product Name; CCP-1 Serial-Parallel Interface 



Equip, req'd: 

Price: 

Manufacturer: 



TRS-80 Color Computer 
$69.96 + shipping 
Botek Instruments 
4949 Hampshire 
Utica, MI 48087 



Description: Botek Instruments serial-parallel interface 
provides the TRS-80 Color Computer and TDP-100 with a 
standard Centronics style parallel interface. The interface, 
housed in a 3 in. by 6 in. mini-box, is easily connected to 
the CoCo RS-232 port. A parallel cable is provided that 
connects the interface to the printer. A third cable leads to 
a small AC power supply. Baud rates of 300 to 9600 baud 
are switch selectable on the front of the interface. POKE 
150,1 will allow CoCo to access the printer at 9600 baud. 
The unit can be configured to ROM 1 .0 or ROM 1 . 1 by just 
changing a jumper. 

Pluses: The interface is easily installed, and requires little 
attention, except to change baud rates. If the printer you 
have is capable of H- 5 volts on pin 18 of the printer connec- 
tor, you may remove the AC supply and power the inter- 
face from your printer. This option is not available on my 
Epson printer, so I could not test it. 

Minuses: None noted. 

Documentation: A single page instruction sheet describes 
hook-up and operation of the unit. In addition, a separate 
sheet contains a complete interface schematic. 

Skill level required: The unit should be easy to install for 
anyone familiar with computer and printer installations. 

Reviewer: John Steiner 



Product Name: 
Equip, req'd: 
Price: 



BASIC Aid 

TRS-80 Color Computer 
$34.95 
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Manufacturer: 



Eigen Systems 
P.O. Box 10234 
Austin, TX 78766 



Description: BASIC Aid is a ROM based programmers 
utility for the Color Computer. Commands may be 
entered using two keystrokes, and keys may be redefined 
as required. A plastic overlay is included to remind you of 
the key codes. Automatic line numbering is supported, 
and lines may be moved from one part of a program to 
another. A MERGE utility allows two BASIC programs to 
be combined. 

Pluses: BASIC Aid works with all CoCo's, 4K on up. ROM 
pack construction requires only 227 bytes of RAM to hold 
the key define table. An auto space command prints a 
space after the defined key for maximum readability. Auto 
space can be shut off should you require memory conserva- 
tion. Programs to be merged may be binary, and do not 
have to be stored in ASCII format unlike many utilities. 
BASIC Aid can be turned off and on from the keyboard 
if desired. 

Minuses: BASIC Aid automatically allocates the top 227 
bytes of available RAM for its key define table, which is 
not relocatable. As a result, you will have to relocate any 
machine-language routines that must be used with your 
program, assuming they are relocatable. In addition, all 
CLEAR commands must be set to protect the top 227 
bytes, or you may accidentally overwrite the table. 



Documentation: The instruction book is excellent, easy to 
understand, and well written. The only conflict I could 
find was in the MOVE utility. The manual asks for line 
numbers in the format 100, but on my machine, 100 
turned into 10000 until 1 entered the numbers with leading 
zeroes, as 00100. 

Skill level required: The program is easy to use, and makes 
programming a much easier task. No extra skills are re- 
quired of the programmer. 

Reviewer: John Steiner 



Product Name: CCEAD Color Computer Editor/ 



Equip, req'd: 

Price: 

Manufacturer: 



Assembler/Debugger 

TRS-80 Color Computer 
$6.95 + $3.00 shipping 
Eigen Systems 
PO Box 10234 
Austin, TX 78766 



Description: This is a BASIC program that provides the 
user with a machine-language software development 
system. You receive two versions: a 12K-(- commented 
source listing and a stripped 7600-byte running version. It 
assembles and stores code in the unused CoCo graph- 
ics pages. 

IContinued on next page) 
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Dealer 

Inquiries 

Invited 



Professional Workmanship 
Guaranteed Repairs 
Quicl< Turn-around 



COMPLETE PRODUCT LINES FOR 
D.C.Hayes • HDE • Microsoft • Nashua • Okidata 

APPLE • FRANKLIN • IBM-PC/XT 

We carry many products at competitive prices to expand tiiese fine computers. 
Request Catalog No. AFP* 

HDE • AIM • SYM • KIM 

HDE hardware and software for ASK, DLC, OMNI-65 systems 

KIM replacement modules (1K — 4K) and keyboards 

AIM-65 (1K — 4K) and accessories. Request Catalog No. TASK* 

COMPUTER REPAIR SERVICE 

Apple 



AIM 



• 


Franklin • 


Atari 


PET 


• HDE 




• 


SYM • 


KIM 



Perry Peripherals 



"Catalogs 

AFP $2.00 TASK $1.50 
Catalog price refunded 
with first order 



Repair Center 

6 Brookhaven Drive 

Rocky Point, NY 11778 



Orders 
P.O. Box 924 (516) 744-6462 

Miller Place NY 11764 9AM— 5PM Weekdays 
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Pluses: The program is inexpensive and easy to use. It 
allows you to "get youi feet wet" in machine-language 
programming for little cost. The BASIC program is easily 
modified to the user's preference. 

Minuses: The program is slow in assembly and allows 
only five directives; ORG, RMB, FCB, FDB, and EQU. No 
math is allowed in labels. 

Documentation: A ten-page manual is provided to 
demonstrate the operation and use of CCEAD. Two sam- 
ple programs are provided that assist in learning to use 
the software. 

Skill level required: This program requires some 
knowledge of machine-language programming. 

Reviewer: John Steiner 



Product Name: SHRINK 

Equip, req'd: Color Computer with 16K memory 
Price: $15.00 tape or disk 

Manufacturer: Star Kits 

P. O. Box 209-N 

Mt. Kisco, NY 10549 



Description: SHRINK is another implementation of Eliza, 
the computerized psychologist. It is fun to use, but it is 
rather easily "fooled" into making somewhat irrelevant 
comments. It will run indefinitely and is a cute demo for 
parties, etc. 

Pluses: SHRINK is a change of pace; you can relax while 
experimenting — an unusual use for a computer. Written 
in assembly language, it is somewhat faster than many 
other similar programs. 

Minuses: A serious experimenter might wish for a more 
sophisticated implementation of this concept. 



Documentation: A single page gives adequate instruc- 
tions; once started, all yoq. need to know is how to stop — 
simply type "shut up"! 



Skill level required: None. 
Reviewer: Ralph Tenny 

iMCftO 
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Questionnaire Analysis Software 




• Microcomputer based 

Avoid the expense of cantroct services -■ do everything in-house on 
your own Apple 11+ microcomputer. 




• Eosy data entry 

Avoid time consuming keypunching. Uses respondent-morked cards 
entered v^ith on Optical Mork Reader (keyboord entry olso passible). 




• Comprehensive dote analysis 

Sort on any vQriable(s), tally all responses, conduct cross tabs, 
correlations, linear regression, frequency distribuf'ons, ond more. 




• Complele editing capobilities 

Weight items, derive composites, odd or delete items, and more 


• Easy-to-use 

Progroms ore user friendly, menu driven, and interoctive. No speciol 
computer expertise is required. 


Call or lend for mare mformatian tadoy. 


SCJE[;iTi^JC SQfTWflHE flSSQCJflTES, iW. 


BQXMfl • WfllJEflU, W;. 51.1.01 


TELEPHQIiiE: (715) ai.5-aQQ,g. 


Apple 11+ is a registered trodemork of Apple Compuler, Inc. 



NOW — FULL POWER ASSEMBLY LANGUAGE!! 

GET THE VERSATILITY OF INDEPENDENTLY 
ASSEMBLED RELOCATABLE SUBROUTINES WITH A 

RELOCATING UNKING LOADER 

* For use with APPLE DOS TOOLKIT ASSEMBLER REL files 

* Relocate and link up to 255 REL files 

* Convenient specification of relocation parameters (output file, 
start address, REL file names, . . .) in text control file 

■ Comprehensive error reporting and recovery 

* Memory map has module and entry point addresses to aid 
debugging 

* Complete with user manual and disk example 

* FAST — ten 256 byte REL files done in 30 SECS 

RELOCATING LINKING LOADER W/MANUAL $49.95 

MANUAL $ 4.50 

Also — FAST-CRYPT — Available for APPLE and IBM 

Encrypt/decript any file with FAST-CRYPT 

An efficient assembly language implementation of the DBS 

(Data Encryption Standard) algorithm 

FAST-CRYPT W/MANUAL $34.95 

KIWI SOFTWARE CO. 
P.O. BOX 218m 
Plainsboro, N.J. 08536 

System requirements: 

APPLE II, II -I- , He (or compatable) DOS 3.3 W/48K 

IBM-PC, XT (or compatable) PC, MS-DOS W/64K 

IBM tm IBM CORP, APPLE tm APPLE COMPUTER, INC. 

MS-DOS tm MICROSOFT CORP. 



KIWI SOFTWARE does not copy protect its products 

send check or money order (N.J. residents add 6% sales tax) 
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Apple To 
Smartmodem 

By John Kelty 
Adapted for Apple by Phil Daley 

This is an adaptation of my pro- 
gram for the Color Computer. 
The hardware requirements are 
the Hayes Smart Modem and an RS-232 
communications interface. This pro- 
gram was specifically written with the 
CPS Multifunction card in slot 1 with 
the serial port assigned to slot 2 (the 
standard slot for communications). 
This program should be easily adapt- 
able to other interfaces. See your inter- 
face manual for any necessary changes. 
Listing 1 ^^^^^^^^^^"^^^^^^"^ 



This fantastic modem can be pro- 
grammed from Applesoft BASIC. 

The interface cable is a standard 
communications cable — DB-25 to 
DB-25, with pin-for-pin connections. 
You need 12-conductor cable and I have 
used as long as about 25 feet without 
any problems. It is convenient 
however, to have the Smartmodem 
near your computer setup, then you 
can hear the dialup and the send and 
receive carrier tones when you begin 
communicating. There are many pro- 
gramming options you can choose with 
the Hayes Smartmodem, and these are 
extremely well documented in the ex- 
cellent Owner's Manual. (In case you 
have not guessed, I consider the Hayes 
Smartmodem my best computing pur- 
chase to date!). 

The BASIC program is menu driven 
for ease of operation. If you BREAK and 
then RUN the program again, the 
Smartmodem functions are cleared 
("AT Z" is sent to the modem). To 
write to the Hayes, merely access the 
slot (with PR#2), and PRINT your com- 
mands. Now you can talk to your 
modem just like it was a printer with 



100 REM ShARToOO 

110 RE« KELTY EHGIHEERING 

120 REM WRITTEN BY JOHN R. KELTY 

130 REM LINCOLN, NEBRASKA 63505 

140 REM 

150 REM USE THIS PROGRAM TO CONNECT 

160 REM m PROGRAM THE HAYES 

170 REM SMARTMODEM TO THE 

180 REM APPLE COMPUTER. 

190 REM 

200 REM THE CONNECTOR CABLE SHOULD 

210 REM CONNECT TO THE RS-232 PORT 

220 REM IN THE FOLLOyiMG yAY: 

230 REM PIN FOR PIN CWWECTION 

260 REM 

270 REM THE 300 BAUD HAYES IWDEM 

280 REM HAY BE USED UITH VIDEOTEX 

290 REM QR ANY OTHER TERMINAL 

300 REM PACKAGE THAT ALLOUS THE 

310 REM HAYES TO RUM AT 300 BAUD. 

320 REM 

330 REM THE HAYES «ILL OPERATE 

3A0 REM LOCALLY AT HIGHER RATES 

350 REM BUT NO HIGHER THAN 300 

360 REM WHILE ON LINE. 

370 REM 

380 REM SEE YOUR USER'S MANUAL 

390 REM FROM HATES FOR DETAILS. 

WO REM 

410 REM ttttttttttttttttttttttttm 

A20 DIM Hi(5),SNV?):Ii» = CVfti (13) + CHRI 

(4) 

430 HOME : PRINT : PRINT " l«»«l SMART « 

ODEM %%m" 

440 PRINT " BY: KELTY ENGINEERING" 

450 PRINT " «««$$«««»$$t««««ttt$»$$" 

460 PRINT : PRINT "CONNECT CABLES TO MODEM, 

II 

470 PRINT "COMPUTER AND PHO« COMPANY." 

480 F-RINT : PRINT : PRINT "(BREAK AND LIST 

THIS PROGRAM TO" 

490 PRINT "SEE CABLE DETAILS)." 



PRINT "your modem command". To 
get back into the normal Apple mode 
use "PR#0". 

Now you can use a communications 
package such as DATA CAPTURE or a 
similar program to communicate with 
bulletin boards or data bases. The pro- 
gram includes a command to enable 
terminal mode on the CPS card, which 
will allow a dumb terminal com- 
munications setup. 

I know little to nothing of amateur 
radio operations, but with a few lines of 
BASIC and possibly some hardware, 
the Hayes Smartmodem can be made to 
send morse code. Auxiliary relay con- 
tacts are provided in the modem to key 
the transmitter automatically. It can- 
not however, be made to directly 
receive morse code. Diagrams describ- 
ing the modem to radio interface are 
found in the Smartmodem User 
Manual Appendix H. Obviously some 
nice commercial terminal packages 
exist for the Apple, but this program 
has made me happy for some time now. 
With the Hayes Smartmodem and the 
Apple Computer, I am sure you will 
also enjoy computer communications. 
ilMCftO 



500 PRINT : PRINT s INPUT "PRESS ENTER UHEN 

510 HOME : PRINT 

520 PRINT D$"PRII2": PRINT "AT Z": REM CLEA 

R MODEM 
530 PRINT D$"PR1W" 

SAO REM tmtt»««nt»titit»«mtt 

550 REM MENU 

560 Mid) = "AUTO DIALING" 

570 M«(2) = "AUTO ANSUERIHG" 

580 FOR S = 1 TO 2 

590 PRINT S" "mS\ 

600 l€XT S 

610 PRINT : PRINT '• PRINT "SELECT ONE OF TH 

E ABOVE" 
620 GET M 

630 ON VAL (At) GOSUB 650,1210 
640 GOTO 430 

650 REM ttnttttmmmtmtmtt 

660 REM AUTO DIALING ROUTINE 

670 REM }«mi«imim«t»mtt»« 

680 REM 

690 HOME : PRINT : PRINT «$(1) 

700 PRINT : PRINT : PRINT "1 DIAL A SAVED K 

UMBER" 

710 PRINT "2 DIAL A NEW NUMBER" 

720 GET M 

730 ON VAL (A$) GOTO 750,950 

740 GOTO 690 

750 REM ttmmtttmmmm 

760 HH = 2: REM HOU MANY NUMBERS 

770 REM TO CHANGE THIS LIST, MAKE HM=HOW 

780 REM MANY V YOU WANT TO LIST (KAX OF 9). 

790 REM THEN INSERT LINES SIMILAR TO THOSE 
800 REM BELOU «ITH YOUf: NUMBERS AND NAMES. 
810 HIWE : PRINT "NUMBERS YfflJ CAN EASILY CA 

LL": PRINT 
820SN$(l) = "l XXX-XXXX A FRIEND 



830 SN$(2) = "2 XXX-XXX-XXXX 



A BBS 
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^■■'^J'?, 



You'll 
Receive: 



Now you can do mbre'wItK'wui^ 
eight projects and -programs Hj^n 
master VIC BASIC .prbgr^m^i^: 
on a particular aspect of 
is accompaii|igd.j^.<flli 

^Qleariiiireclioni 
writing 
adi 



"^ MICRO CdlC.a miniature spread- 
sheet program that malces complex, repetitive 
calculations a breeze. 



"^^ MASTER. ..a guessing game that teaches 
programming with random numbers and flags. 




yj 



itMres p 



*^sm 






"•^'■^■^ "•' J.' L' ^WW^^^h^^'' 



^akr^fadykeyedlni; 



'^ VIC CIOCk...to teach you ON..GOSUB function 
and character graphics. 



BREAK-UP.. .a DODular came that also teaches how 




■vikm^'^' 



V- 



animation is achieved with PEEKS and POKES to screen memory. 



Use this coupon or the postage paid card in this issue to order 

MICRO Books P.O. Box 6502, Chelmsford, (VIA 01824 



D YES, please rush . 



copies of MASTERING YOUR VIC-20 (w/cassette)^ 



at only $19.95 per copy (plus $2.00 s/h, MA res. add 5% sales tax). 



My payment of $_ 



is enclosed. I'm paying by D Check D MO 

D VISA D MC 



NAME 



ADDRESS 
CITY 



STATE. 



.ZIP. 



CREDIT CARD #. 



.EXP. DATE 



Allow M weeks for delivery. 



"^^ Plus... music programming, 
string manipulation, sorting 
demonstrations, and more. 

Each Program 

Worth the Price 

of the Book! 

Order your copy of 

MASTERING 
YOURVIC-20 

Today! 



TERMINALS 

910 $519.00 

91 Plus $599.00 

914 $569.00 

924 $689.00 

925 $739.00 

950 $929.00 

970 $1039.00 

COMPUTERS 

Teleport Portable CALL 

800A $1 099.00 

802 $2699.00 

803 $1949.00 

802H $4695.00 

806/20 $4999.00 

81 6/40 $91 99.00 

1 602 $3399.00 

1603 CALL 



^TelcVideo 



IBM 





Spirit XL Portable $3999.00 

IIE-1 $1 369.00 

IIE-2 $1649.00 

IIE-3 $2399.00 

IIE-4 $31 99.00 

PCE $1579.00 

PC-1 $2399.00 

PC-2 $2799,00 

PC XL $3599.00 

1 620 $3599.00 

1 630 $5499.00 

1 640 $6499.00 

Cyma Software CALL 



^ SANYO 

MBC-550 PC CALL 

MBC-555 PC CALL 

MBC 1100 $1599.00 

MBC 1150 $2099.00 

MBC 1200 $1999.00 

MBC 1 250 $2399.00 

FDD 3200-320K Drive $399.00 

FD0 6400-64K Drive $499.00 

PR 5500 Printer $699.00 

MONITORS 

AMOEK 

300 Qreen $ 1 49.00 

300 Amber $159.00 

31 Amber $1 69. DO 

Color 1 $279.00 

Color 1 Plus $299.00 

Color 2 $399.00 

Color 2 Plus $419.00 

Color 3 $349.00 

Color 4 $699.00 

BMC 

12" Green $79.99 

12" Green HIRES $119.99 

9191-13" Color $249.99 

GORILLA 

12" Green $88.99 

1 2" Amber $95.99 

NEC 

JB 1 260 Green $1 09.99 

JB 1201 Green $149.99 

JB 1205 Amber $159.99 

JC 121 5 Color $299.99 

JC 1216 RGB $429.99 

QUAORAM 

Quadchrome $499.99 

TAXAN 

1 2" Green $ 1 1 9.00 

12" Amber $129.00 

Taxan 1 RGB $279.00 

USi 

Pi 1 , 9" Green $99.99 

Pi 2, 12" Green $119.99 

Pi 3, 12" Amber $149.99 

Pi 4, 9" Amber $1 39.99 

1 400 Color $269. 99 

ZENITH 

ZVU 122 Amber $99.99 

ZVM 123 Green $89.99 

ZVM 1 35 Color/RGB $469.99 




MODEMS 

ANCHOR 

Mark I (RS-2321 $79.00 

Mark II (Atari) $79.00 

Mark III (TI-99) $109.00 

Mark IV(CBM/PET) $125.00 

Mark V (Osborne) $95.00 

Mark VI (IBM-PC) $169.00 

Mark VII (Auto Ans/Auto Dial) ... $1 1 9.00 

Mark XII (1 200 Baud) $299.00 

TRS-80 Color Computer $99.00 

9 Volt Power Supply $9.00 

HAYES 

Smartmodem 300 $219.00 

Smartmodem 1 200 $509.00 

Smartmodem 1200B $459.00 

Micromodem It $265.00 

Micromodem II Plus $299.00 

Micromodem IIE $269.00 

Micromodem 100 $299.00 

Smart Com II $89.00 

Chrono9raph $1 99.00 

NOVATION 

J-Cat $99.99 

SmartCat 103 $179.00 

SmartCat 103/212 $399.00 

AutoCat $21 9.00 

21 2 AutoCat $549.00 

Apple Cat II $249.00 

21 2 Apple Cat $569.00 

Apple Cat 212 Upgrade $309.00 

Cat $139.99 

D-Cat $1 49.00 

PC -Cat $339.00 

ZENITH 
ZT-1 $369.00 

APPLE INTERFACE 
CARDS & BUFFERS 

Choose from PKASO, Orange Micro, 
MPC, MicroMax, Tymac, Quadram & 
Practical Peripherals CALL 



iMEc 35sa m^ eaa.aa 

PERCOM/TANOON 
DRIVES 

5V«" 320K Floppy $249,00 

5 Me9 Hard w/Controller. . . $1 399,00 
10 Meg Hard w/Controller , , . $1 699,00 
1 5 Meg Hard w/Controller , , , $2095.00 
20 Meg Hard w/Controller . . . $23gg.00 
AMOEK 

31 OA Amber Monitor $169.00 

DXY 100 Plotter $599.00 

Color II $399.00 

AST RESEARCH, INC. 

Six Pak Plus... from $279.00 

Combo Plus II... from $279.00 

Mega Plus... from $309.00 

I/O Plus II. ..from $139.00 

QUAORAM 

Ouadlink $549.00 

Quadboard...as low as $289.00 

Quad 51 2 Plus...aslowas . ..$249.00 

Quadcolor...as low as $21 9,00 

Chronograph $89.00 

Parallel Interface Board $89.00 

64K RAM Chips Kit $59.00 

MICRO PRO 

WordStar/Mail Merge $369.00 

InfoStar $299.00 

SpellStar $1 59.00 

CalcStar $99.00 

MICROSTUP 
Crosstalk $1 05.00 

MICROSOFT 
Uultiplan $1 59.00 

APPLE IBfvl 

Write: 79.00 89.00 

Graph: 79.00 89,00 

Report: 79 00 79.00 

File: 79.00 89.00 

Solutions': as lowas 16.00 16.00 
■Call On Titles 




ASHTON-TATE 

dBASE II $399.00 

lUS 

EasyWrlter II $1 89.00 

EasySpeller $ii 9.00 

EasyFiler $229.00 

COIMTINENTAL SOFTWARE 
1stClassMail/Form Letter ..$79.00 
The Home Accountant Plus ..$88.00 

SYNAPSE 

File Manager $89,00 

LOTUS 

1-2-3 $319.00 

PROFESSIONAL SOFTWARE 
PC Plus/The Boss $379,00 

VISICORP 

IBfVI APPLE 

VIsiCalc 
VisiCalc4 
VisiCalc-Advanced 
VIsiWord/Spell 



Visitrend/Plot 

VIsiLInk 

VIsiFlle 

VisiSchedule 

Visidex 

VIsiPlot 

VisiTerm 

Desktop Plan 

Bus, Forecast Model 

Stretch Calc 

VisiTutor Calc 

VIsiTutor- Advanced 

VisiTutor Word 

Vision Calc 

Vision Graph 

Vision Mouse 

Vision Host 



159.00 
159.00 

269,00 
249 00 
199,00 199 00 

169.00 
199,00 169.00 
199.00 199.00 

159,00 

135.00 

75,00 

199 00 169 00 

75.00 75,00 



75,00 

59.00 

75.00 

59.00 

249.00 

129.00 

159.00 

31900 



75.00 
59,00 
75,00 
59 00 



PRINTERS 



AXIOM 

AT-100 Atari Interface $249,00 

C0-100CBM64/VIC 20 .,..$249,00 

GP-1 00 Parallel Interlace ...$199.00 

BMC 

401 Letter Quality $589.00 

BX-80 Dot Matrix $269.00 

CENTRONICS 

1 22 Parallel $499.00 

739-1 Parallel $399.00 

739-3 Serial $449.00 

C.ITOH 

Gorilla Banana $209.00 

Prowriter 851 OP $379.00 

Prowriter 1 550P $679.00 

A1 (1 8 cps) 569.00 

F1 0-40 $999.00 

F10-55 $1 499.00 

COMREX 
ComWriterll LetterOuality . . . $549.00 

DIABLO 

620 Letter Quality $949.00 

630 Letter Quality $1 749.00 

OAI8YWRITER 

2000 $999.00 

2500 CALL 

Tractor Feed $109.00 

EPSON 
MX-80FT, MX-100. RX-80, RX-80FT, 

FX-80, FX-100 CALL 

I08 

Prism 80.. .For Configurations.. .CALL 

Prism 32. ..For Configurations.. .CALL 

MANNESMAN TALLY 

1 60L $589.00 

1 80L $799.00 

Spirit 80 $309.00 



NEC 

8023 Dot Matrix $379.00 

8025 Dot Matrix $669.00 

2050 Letter Quality $999.00 

3510 Serial/ Letter Quality... $1449. 00 
3530 Parallel/Letter Quality ... $1 499.00 
3550 IBM/Letter Quality ... $1 699.00 
7710/7730 Serial/Parallel... $1949. 00 

OKIOATA 

82,83,84,92,93,2350,2410 ,CALL 

SMITH CORONA 

TP-2 $449,00 

Tractor Feed S1 1 9.00 

SILVER REEO 

500 Letter Quality S469.00 

550 Letter Quality $699.00 

STAR 

Gemini 10X $299.00 

Gemini PI 5 $449.00 

Delta 1 $559 00 

Serial Board $75.00 

TOSHIBA CALL 

TRAN8TAR CALL 

PRINTER CABLES 

Available for Atari, Commodore. IBM, 
Apple, Epson, Kayprti, Televideo. Frank- 
lin, Eagle, Sanyo, Osborne, NEC, 
Zenith and many others. We supply a II 
your computer needs! 



PAPER SUPPLIES 

lOOOshts, 8V1XII Tractor Paper... 19.9S 
1000shts.14V»1 1TractorPaper..$24.99 
1 or 2" Address Labels $9.99 



§pO'648-551f 

BInNVcall (702)588 5654 Dept 01 1 5 
Order Status Number 588-5654 
P.O. Box 6689, Stateline NV 89449 



800-268-*! 



4559 800-235.8950 



in Toronto call (41 6-828-0866. Dept. 01 1 5 

Order Status Number: 828-0866 

2505 Ounwin Drive. Unit IB 

Mississauga. Ontario. Canada L5L1T1 



In PA calt (717)327-9575. Dept 0115 

Order Status Number: 327-9576 

Customer Service Number 327-1450 

477 E. Third St.. WiUiamsport. PA 17701 



Ha nah no rfepostt an COD. orders. Pre-paid orders receive free shipping within the UPS continental United States vi^ith no waiting period (or certified checks or, 
money orders. Add 3'^-d (minpmum S5.00) shipping and handling on all C.O.D. and credit card orders. Larger shipments may require additional charges. NV and PA 
(Csidents add sales tax. All items subject to availability and price change. We stock manufacturer s and third party software for mostaN computers on the market Cad 
today for our catalog- 




ACE 1000 Color Computer ...CALL 

ACE Family Pack System CALL 

ACE PRO PLUS System CALL 

ACE 1 200 Office Mgmt. System . . . CALL 
■NOT PIE EXPENSIVE 



APPLE/FRANKLIN 
□ ISK DRIVES 

MICRO-8CI 

A2 $219.00 

A40 $299.00 

A70 $319.00 

C2 Controller $79.00 

C47 Controller $89.00 

PANA 

Elite 1 $279.00 

Elite2 $389.00 

Elite 3 $569.00 

APPLE lie STARTER PACK 

64K Apple Me, Disk Drive & Controller, 
ao Column Card, Monitor II & DOS 3.3 
COMPLETE $1 499.00 



^E commodore 



CBM 4032 $599.00 

CBM 8096 $869.00 

CBM 9000 $999.00 

B1 28-80 $769.00 

CBM 64K Memory Board... $269.00 

8032 to 9000 Up9rade $269.00 

2031 LP Disk Drive $299.00 

8050 Disk Drive $949.00 

8250 Disk Drive $1199.00 

4023 Printer $379.00 

8023 Printer $569.00 

6400 Printer $1399.00 

ZRAM $499.00 

Silicon Office $699.00 

The Manager $199.00 

Soft ROM $1 25.00 

VisiCalc $1 59.00 

PROFESSION AL 
SOFTWARE 

Word Pro 2 Plus $159.00 

Word Pro 3 Plus $189.00 

Word Pro 4 Plus/5 Plus., each.. $279 00 

IntoPro $1 79.00 

Administrator $399.00 

Power $79.00 



CBM 

aoss 






CBM 6<4 S199 

VIC SO CALL 

C1S41 Disk Drive $249.00 

01 530 Datasette $69.00 

C1 520 Color Printer/Plotter... $169.00 
C1525 Dot Matrix/Parallel... $21 9.00 
CI 526 Dot Matrix/Serial . . , ,$279.00 

C 1 702 Color Monitor $249.00 

C 1 3 1 1 Joystick $4.99 

C 1 31 2 Paddles $1 1 .99 

C1 600 VIC Modem $89.00 

C1 650 Auto Modem $89.00 

Logo 64 $49.00 

Pilot 64 $39,00 

Simon's Basic $19.00 

Word Pro 64 Plus $59.00 

Parallel Printer Interface $69.00 

Calc Result 64 $1 29,00 

Codewriter 64 $75,00 

Ouick Brown Fox $49,00 

Word Pro 64 Plus S59.00 



We Stock a full inventory of software for Commodore, such as: 
Artworx, Broderbund, Commercial Data. Creative Software. 
Epyx, HES, MicroSpec, Nufekop, Romox, Sirius, Synapse. 
Tfiorn EMI. Tronix, UMI, Victory, Spinnaker, RainbowA Timeworks' 
CALL FOR DETAILS! 



HANDHELa COMPUTERS 




41 cv ssoa 



41CX SS59 

HP IOC $51,99 

HP 1 1C $69.99 

HP 12C $88.99 

HP 15C $88.99 

HP 16C $88.99 

HP 75C $749.99 

HPIL Module $98.99 

H PI L Cass, or Printer $359,99 

Card Reader $1 43,99 

Extended Function Module - ,, $63.99 
Time Module $63.99 

NEC 

PC-8201 Peraonal Computer... $599.00 
PC'a221AThermal Printer... $149.00 
PC-8281A Data Recorder ,,.,$99,00 
PC-8201 -06 8K RAM Chips,, $1 05, 00 
PC-8206A 32K RAM Cartridge., $329.00 




PC-15CaA...SieS.99 
PC-1 SSOA SSS.99 

CE'1 25 Printer/Cassette, , , . $1 28,99 
CE-1 so Color Printef/Cassette„,$1 71 ,99 

CE-1 55 8K RAM $93.99 

CE 181 16KRAM $134.99 

CE 500 ROM Library $29.99 

TIMEX/SINCLAIR 

1000 

Timex/Sinclair 1 000 $35.99 

1 6K Memory $29.99 

2040 Printer $99.99 

VuCalc $1 7,99 

Mindware Printer $99,99 



A 

ATARI 



HOME COMPUTERS 




eoOXL S18S 

SOaXL SS99 

1010 Recorder $74,00 

1 020 Color Printer $249 ,00 

1025 Dot Matrix Printer $449,00 

1027 Letter Quality $299,00 

1 030 Direct Connect Modem , , , CALL 

1 050 Disk Drive $379,00 

CX30 Paddle $1 2,00 

CX40 Joystick each„.$8,00 

CX77 Touch Tablet $64,00 

CX80 Trak Ball $48,00 

CX85 Keypad ; $105,00 

4003 Assorted Education $47,00 

401 1 Star Raiders $33,00 

401 2 Missile Command $29,00 

401 3 Asteroids $29,00 

5049 VisiCalc $1 59,00 

7097 Logo $79,00 

7101 Entertainer $69,00 

7102 Arcade Champ $75,00 

8026 Dig Dug $33,00 

8030 E,T, Phone Home $33,00 

8031 Donkey Kong $39,00 

8036 Atari Writer $79,00 

8040 Donkey Kong, Jr $39,00 

8043 Ms, PacMan $39,00 

8044 Joust $39,00 

aiSKETTES 

MAXELL 

5'/4- MD-1 $29,00 

5V." MD-2 $39,00 

8" FD-1 (SS/DD) $39,00 

8' FD-2 (OS/DD) $49,00 

VERBATIM 

5y4- SS/DD $25,99 

5'/4" DS/DD $36,99 

ELEPHANT 

5y4 " SS/SO $1 8,49 

5V4 " SS/DO $22,99 

5y4" DS/DO $28.99 

HEAO 
5'/4 " Disk Head Cleaner $14.99 

DISK HOLDERS 

INIMOVATIVE COrsiCEPTS 

Flipn-File 10 $3,99 

Flip-n-File 50 $1 7.99 

Flip'n-Filei4aO/800ROM)Holdef..$1 7.99 

L^K ENTERPRISES 

Atari Letter Perfect-Disk(40/80|, ,, $79.99 
Atari Utter Petfec^ROM(40 col). ,,$79.99 
Atari Letter PeifectROM(80 col). ,,$79.99 

Atari Data Pel4ec^HOM(80 col) $79,99 

Atari Spell Perfect-DISK $59,99 

Atari Utility/MailMerge $2 1 ,00 

Apple Letter Perfect $99,00 

Apple Data Perfect $75,00 

Apple LJK Utility $21,00 

Apple Lowercase Generator , . , SI 9,00 



1 SOOXL 

1 4aaxL 



CALL 
CALL 



PERSOM 



AT 88-S1 $329,00 

AT 88-A2 $259.00 

AT 88S2 $529.00 

AT 88-S1 PD $429,00 

AT 88-DDA $11 9.00 

RFD 40S1 $449.00 

RFD 40-A1 $269.00 

RFD 40-S2 $699,00 

RFD 44-S1 $539,00 

RFD 44-S2 $869,00 

TEXAS INSTRUMENTS 

TX99-S1 $279,00 

RANA 

1000 $319,00 

TRAK 
ATD2 $389,00 

MEMORY BOAROB 

Axlon 32K $59,00 

Axlori 48K $99,00 

Axlon 1 28K $299,00 

Intec 32K $59,00 

Intec 48K $85,00 

Intec 64K $99,00 

Intec Real Time Clock $29,00 

ALIEN VOICE BOX 

Atari $119,00 

Apple $149,00 

KOALA PAD 

Atari $75,00 

Apple ,,,.$85.00 

IBM $95.00 

CBM 64 $75.00 

CONTROLLERS & 

JOYSTICKS 

wica 

Joystick $21 .99 

3way Joystick $22.99 

Famous Red Ball S23.99 

Power Grip $21 .99 

BOSS Joystick $17.99 

ATARI/VIC Trak Ball $34.99 

Apple Trak Ball $54.99 

Apple Adapter $1 5.99 

Apple Analog $37.99 

KRAFT 

Joystick $41 .99 

Atari Single Fire $12.99 

Atari Switch Hitter $15.99 

Apple Paddles $34.99 

IBM Paddles $34.99 

IBM Joystick $46.99 

AMIGA 

31 00 Sirigle $1 3.99 

31 01 Pair $1 9.99 

Joyboard $37.99 

TG 

Atari Trak Ball $47.99 

Apple Joystick $47.99 

Apple Trak Ball $47.99 



800.648.551f aOO 



268-'5'559 



In NV call 1702)5885654. Dept 0115 

Order Status f^umber; 588-5654 
P.O. Box 6689. Stateline. NV 89449 



n Toronto call (416-828-0866. Dept 0115 

Order Status Number: 828-0866 
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800«255'895Q- 
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CANADIAN ORDERS: All prices are subject to shipping, tax and currency fluctuations. Call for exact pricing in Canada. 
INTERNATIONAL ORDERS: All sfiipments outside the continental United States must be pre-paid by certified check oniy. 
handling. EDUCATIONAL DISCOUNTS: Additional discounts are available to qualified Educational Institutions. 
APO a FPO: Add 3% (minimum S5 00) shipping and handling. 




840 FOR K = 1 TO H« 

850 PRIHT SW(K) 

860 HEXT 

870 PRINT : PRINT "SELECT WC OF THE ABOVE" 

880 PRINT "(BREftK MID LIST TO EDIT THESE NU 

NBERS)." 
890 GET A$ 
900 NE = VAL (A») 
910 IF NB ( 1 OR MB > Wi THEN 750 
920 ?i = HID* (SN$(HB),5,16) 
930 GOSUB 1070 
9A0 RETURN 

950 RQi ««m*miiimiiiim>io 

960 PRINT : PRINT "DIALING A NEU WJHBER" 
970 PRINT : PRINT "TYPE IN THE PHONE NUMBER 

THAT" 
980 PRINT "YOU WSH TO CALL." 
990 PRINT "EXAHF'LES:" 
1000 PRINT "1-800-XXX-XXXX LONG. DISTANCE 

1010 PRINT "112-BOO-XXX-XXXX FROH LINCOLN 

1020 PRINT "XXX-XXXX LOCAL CALL 

1030 PRINT 

1040 INPUT "TYPE DESIRED NUMBER": P* 

1050 GOSUB 1070 

1060 RETURN 

1070 REN %tmtttm%%tmtmttim 

1080 REN NUMBER KNOWN AT THIS POINT 
1090 REN READY TO DIAL 

1100 PRINT D*"PRtl2": PRINT "AT T FO D"P» 

1101 REN TOUCH TONE, IF YOU UANT PULSE, U 
SE 'P' 

1105 REN OttNGE THE '0' TO '1' FOR FULL DU 

PLEX 
1110 PRINT D$"PRIW" 

1120 REN nutmmttmttmtmt 

1130 REM YOU CAN RUN ANY TERMINAL 

1140 REN PACKAGE THAT YOU HISH BY 

1150 REN EDITING THE NEXT LINES. 

1160 REN PRINT D*"RUN TERMINAL PROGRAM" 

1170 HONE : PRINT : PRINT "YOU NEED TO USE 

YOUR OUN" 

1180 PRINT "TERMINAL PACKAGE AT THIS POINT" 

1190 PRINT "(SUCH AS VIDEOTEX AND OTHERS)." 

1200 GOTO 1970 

1210 REM tntttrntttnutm 

1220 REN AUTO ANSWER ROUTINE 

1230 REM mt«iini»»»im 

1240 REN 

1250 HOME : PRINT : PRINT M$(2) 

1260 PRINT 

1270 REM MEfSJ 

1280 AN$(1) = "DO NOT ANSWER" 

1290 AM«(2) = "ANSWER IMMEDIATELY" 

1300 AN$(3) = "ANSWER AFTER XX RINGS" 

1310 FOR SA = 1 TO 3 

1320 PRINT SA;AN$(SA) 

1330 NEXT SA 

1340 PRINT : PRINT : PRINT "SELECT ONE OF T 

HE ABOVE" 
1350 GET A$ 

1360 HOME : PRINT : PRINT " "M$(2) 
1370 ON VAL (A») GOSUB 1390,1470,1640 
1380 GOTO 1210 

1390 REM nmttttmmmtutttt 

1400 REM DO NOT ANSWER 

1410 PRINT : PRINT " m"AN$(l)"m" 

1420 PRINT : PRINT "THE SMART MODEM ANSWER 

FUNCTIW" 

1430 PRINT "IS DISABLED." 

1440 PRINT D*"PR«2": PRINT "AT S0=0" 

1450 PRINT D$"PR«0" 

1460 GOTO 1970 

1470 REM uttttttmmtmtntttt 

1480 REM ANSWER IM)£DIATELY 



1490 PRINT " W"AN«2)"»»" 

1500 PRINT "THE SMART MODEM WILL ANSWER ALL 

II 

1510 PRINT "CALLS IMMEDIATELY." 

1520 PRINT "USE THIS TO TRANSFER CALLS THAT 

II 

1530 PRINT "ARE ALREADY IN PROGRESS BETWEEN 

II 

1540 PRINT "TWO INDIVIDUALS TO COHMUNICATIO 

W 

1550 PRINT "BETWSN THEIR CWUTERS." 

1560 GOSUB 1800 

1570 PRINT Dt-PRtt": PRINT "AT"DP*"A" 

1580 PRINT D$"PR«0" 

1590 PRINT "AT THIS POINT YOU NEED TO RUN" 

1600 PRINT "OR EXEC YOIR OWN RECEIVER" 

1610 PRINT "PROGRAM TO INTERPRET THE" 

1620 PRINT "INCOMING CALL." 

1630 GOTO 1970 

1640 REM tmttttmtmtnn 

1650 REM ANSWER AFTER XX RINGS 

1660 PRINT : PRINT " m"AN*(3)"l«" 

1670 PRINT : PRINT "THE SMART MODEM WILL AN 

3WER ALL" 
1680 PRINT "CALLS AFTER THE NUMBER OF RINGS 

1690 



PRINT "YOU SELECT (FROM 1 TO 255 RINGS 
v 

'print 

input "how many rings (1 to 255)";rg 

1720 RG = INT (RG) 

1730 IF RG < 1 OR RG ) 255 THEN 1710 

PRINT : PRINT "T* PHONE WILL BE ANSWE 
RED" 

PRINT "AFTER"RG"RINGS." 

GOSUB 1800 

PRINT D$"PR«2": PRINT "AT"DP$"SO="RG 

PRINT D«"PRW" 

PRINT : GOTO 1590 

REM »iti»mii«ii*tm**it* 

REM FULL OR HALF DUPLEX 
PRINT : PRINT "DO YOU WANT FULL OR HAL 
F WJPLEX?" 
PRINT "(IF YOU DO NOT KNOW, TRY HALF). 



1700 
1710 



1740 

1750 
1760 
1770 
1780 
1790 
1800 
1810 
1820 

1830 



1840 PRINT : PRINT "1 FULL DUPLEX" 

1850 PRINT "2 HALF DUPLEX" 

1860 GET A( 

1870 ON '^ (Ai) GOTO 1880,1920 

1880 REM FUa DUPLEX 

1890 DP* = "Fl" 

1900 PRINT : PRINT "FULL DUPLEX SELECTED." 

1910 GOTO 1950 

1920 REM HALF DUPLEX 

1930 DP* = "FO" 

1940 PRINT : PRINT "HALF DUPLEX SaECTED." 

1950 PRINT 

1960 RETURN 

1970 REM tttmmtttmtttutttu 

1980 REM EXIT ROUTINE 

1990 PRINT : PRINT "THIS PROGRAM HAS ENDED. 

ti 

2000 PRINT "THIS PROCRfW WILL GO INTO" 

2010 PRINT "TERMINAL MODE IN 5 SECONDS" 

2015 PRINT " " 

2020 PRINT "TYPE 'CTRL-C' FOR LOWER CASE" 

2030 PRINT "TYPE 'CTRL-A' FOR SENDING LINE 

FEEDS" 

2040 PRINT "TYPE 'CTRL-R' 'CTRL-X' TO EXIT 

TERMINAL MODE" 

2060 PRINT " " 

2065 FOR I = 1 TO 10000: NEXT 

2070 PRINT D*"PR«2": PRINT CHR* (9)"H" 

2080 REM THIS PUTS MOUNTAIN CPS CARD 

2090 REM INTO HALF DUPLEX TERMINAL MODE 

2100 REM FOR FULL DUPLEX SUBSTITUTE 

2110 REM AN 'F' FOR THE 'H' IN ABOVE LINE 

2120 PRINT D«"PRW": END MCOO 



78 



MICRO 



No. 68 - January 1984 




Enhanced 
Apple DOS 



Speedload 

requires: 

Apple II or Apple II + or Apple 
lie 48K or 64K with disk 
drive(s) and DOS 3.3 (16 
sectors). 



By Enrico Colombini 



T' 



No. 68 - January 1984 



■ his article describes how to build 
an enhanced version of Apple 
DOS 3.3 which performs all 
loading operations about four times 
faster then original DOS. The modified 
DOS is fully compatible with a 48K 
slave DOS, including inner routines 
and addresses, excepted that it cannot 
format new diskettes for the first time. 



Why Apple DOS Is So Slow 

Since I started using Apple, I was 
puzzled by the apparently strange 
behaviour of the Disk Operating 
System. Why the DOS itself is loaded 
much faster than a binary file of equal 
length? A slave DOS 3.3 is loaded in 
less than 2 seconds. A file of equal size 
(9.25K) is loaded in about 11 seconds. 
Even considering the time spent in 
looking at index and other file informa- 
tions, there is still a great difference in 
loading times. With an ear at the head 
steppin-motor and a hand on the stop- 
watch, I measured the average track- 
loading time: about 3.70 seconds. If 
you consider that the disk rotates at 
five turns per second (a turn in 200 
msec], you can see that the entire track 
passes under the head 3.70 by 5, that is 
over 18 times! Why is it not possible to 
load the track in just one revolution of 
the diskette? Where is the theoretical 
limit? And the practical one? For the 
MICRO 



answers, we must look at the Apple 
hardware and at the inner structure 
of DOS. 

Apple does not have a specialized 
disk controller chip as Western Digital 
1791 or similar device. It has instead a 
little masterpiece of engineering: a 
"state machine" based on a PROM and 
a shift register. This circuit performs 
the hardware encoding/decoding opera- 
tions to and from the R/W electronics 
of the disk drive. But that simplicity 
has a cost: the encoding/decoding pro- 
cess is not complete. It just sends to or 
receives from the disk drive a stream of 
6-bit "nibbles". The remainder of the 
process, that is the nibbles-bytes con- 
version, has to be done by software. 

Every track is organized as a stream 
of 16 sectors, 256 bytes each. In 
reading, the software conversion of a 
sector (342 nibbles to 256 bytes| takes 
about 10 msec. In theory, it is therefore 
possible to read the entire track (200 
msec) and then decode it (10 msec by 
16 = 160 msec) in only 360 msec. But 
this implies a great waste of space for 
the nibblized-track buffer: 342 by 16 
= 5472 bytes of memory! It is not 
acceptable. 

A more realistic approach is to read 
and decode one sector at a time. That 
is, read a sector and decode it, read the 
next sector and decode it, and so on. 
Ok, but what is the NEXT sector? 
While the program decodes the first 
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— RDIBYT calls another routine 




which increments the POSITION file 


Figure 1: Sector interleaving 


pointer. After that, it returns with the 
wanted byte to main file manager 


Access order by R/W head of disl( drive '<] 


routine. 


01 23456789ABCDEF Piiysical sectororder 


— File manager returns to external 
level. 


07E6D5C4B3A2918F Logical sector order 


— External level returns to Basic with 
the first character. 




The above procedure is repeated for 




every character requested by Basic. 



sector, the next physical sector (the 
second) passes under the head and can- 
not be read. Since the decoding time 
(10 msec) is shorter than the sector 
duration (12 msec approximately in- 
cluding header), the program can safely 
read the third sector. After that, it loses 
the fourth, reads the fifth and so on. 

It is so possible to read only 8 sec- 
tors per disk revolution. Starting with 
the disk head at the beginning of the 
first sector, it takes two turns (400 
msec) to read the entire track: reducing 
the buffer from 5472 bytes to only 342, 
we lost about 10% of speed. A very 
good compromise. Considering a head 
positioning and first sector finding time 
of 150 msec (average), we can expect to 
read a track in about 550 msec, or .55 
seconds. The DOS track loading time is 
near to this value, so we can consider 
this time (550 msec) as the practical 
speed limit. 

Well, Apple can load a track in .55 
seconds. Yet we do not know why DOS 
cannot. We must find the reason in the 
deepest depths of DOS itself. 

The Cost of Structured 
Programming 

I like structured programming. It 
improves program development, 
testing, debugging and reading. The 
program occupies less memory and is 
much more easy to modify, even by 
another programmer. I make large use 
of it in every language, including Basic, 
and I am greatly rewarded: my work is 
much easier. All these advantages are 
achieved at only one cost: the program 
runs slower. How much slower it runs, 
it depends on the level of structuring. 
More deep the structure, more slow the 
program. For some time-critical pro- 
grams, structuring to the deepest level 
can be a great disadvantage. For these 
programs, the programmer must find 
the better compromise, that is the level 
where it must stop structuring and 
start ' ' spaghetti-programming' ' . 
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Apple DOS is a deeply structured 
program, It is very well written and can 
be easily adapted to different diskette 
organization, that is shorter sectors, 
more tracks, etc. At the moment, 
however, the 3.3 version is widely 
accepted and the coming of another 
version is very unlikely, unless the 
DOS is wholly changed for new disk 
drives. We can therefore see if the 
slowness depends on the DOS structure 
and, if it is so, see if it is possible to 
reduce the structure level and so speed 
up the operations. 

Apple DOS is made mainly of three 
blocks, in order of depth: 

— The external level, which is the in- 
terface with Basic, monitor and user. 

— The file manager, which performs 
all operations on diskette files. 

— The RWTS, which physically 
reads/writes a single disk sector. 

This is (roughly) the sequence of opera- 
tions when Basic inputs a string from a 
sequential text file, already opened: 

— Basic calls input routine for getting 
the first character. Since READ com- 
mand is in effect, DOS intercepts 
the call. 

— DOS external level calls file 
manager asking for a single character 
from active input file. 

— File manager calls its internal 
routine "read one byte" (RDIBYT). 

— RDIBYT calls a routine which, if a 
byte is not already available, finds and 
loads the next sector in the buffer 
(using RWTS). 

— RDIBYT gets the requested byte 
from the buffer. 

— RDIBYT calls a routine which in- 
crements the pointer (offset) in current 
record. In case of sequential files, 
records are of course one byte long. 
Since end of record is reached, the 
record counter is incremented and the 
offset is reset to zero. 

MICRO 



Just a little confused by this 
simplified explanation? Well, think 
that all increments and calculations are 
done in 16 bit arithmetic and you may 
begin to understand why sequential 
files reading is so slow. But, you will 
ask, what has that to do with loading of 
Basic or binary files? It has since DOS, 
as I said, is highly structured: it loads 
these files using the same above 
described procedure, as if they would 
be text files! So, Basic and binary 
loading is very slow too. 

The SPEEDLOAD Approach 

How much is the wasted time, in 
terms of disk sectors? When DOS is 
loading a Basic or binary file, after call- 
ing RWTS for reading a sector it waits 
for a little less than 100 msec (8 sectors 
or half a track) before calling the RWTS 
again for the next wanted sector. 

I must now explain another feature 
of Apple DOS: sector interleaving. 
Using RWTS driven by a fast routine, 
as it happens when loading DOS, it is 
possible to load a sector every two, ac- 
cording with our former analysis. Max- 
imum speed can be achieved only if 
sectors are loaded in that order. In DOS 
3.3, every track is initialized with sec- 
tors in ascending order, that is starting 
with sector $0 and ending with sector 
$F (hex). But this is the physical sector 
order. Using a table called "interleav- 
ing table", DOS make use of the sec- 
tors as if they were in another order, 
the "logical order". 

Figure 1 shows the correspondence 
between physical and logical sector 
numbers. The upper line represents the 
sector numbers in a track as they are 
physically written on the diskette dur- 
ing initialization process. The lower 
line shows the sector numbers as they 
are used by the DOS (the RWTS). DOS 
stores sectors in descending logical 
order, that is starting with sector $F 
and proceeding towards sector $0. 
Every sector is stored in the physical 



81 



sector located through the interleaving 
table. For example, logical sector $F is 
stored in physical sector $F, logical $E 
in physical $2, $D in $4 and so on, as 
stated by the table in fig. 1. As DOS 
always uses sectors in logical order, 
you can forget the upper line and look 
only at the lower line (logical order]. 

When loading DOS itself, after 
reading sector $7 it must be decoded. 
During this operation, sector $E passes 
under the head, unnoticed. When 
RWTS is ready for reading sector $6, it 
is just this sector which passes under 
the head, with very little delay. The 
loading time is thus optimized. The 
situation is very different when loading 
a Basic file (it is the same matter with a 
binary file) : the time needed by the file 
manager for processing sector $7 is so 
great that in the meanwhile sectors 
$E,$6,$D,$5,$C,$4,$B and $3 pass 
under the head. When at last DOS is 
ready for reading sector $6, that one is 
already passed by and it has to let sec- 
tors $A,$2,$9,$1,$8,$F,$0,$7 and $E 
pass under the R/W head before it can 
at last read sector $6. 17 sectors to 
wait: a very long time! 

In the book Bag of tricks by Don 
Worth and Peter Lechner (published by 
Quality Software) you can find a 
similar description of the problem. The 
authors call the time wasted in waiting 
the next sector to read "rotational 
delay' ' and the time wasted in process- 
ing a sector "file manager overhead". 
Searching for a solution, they discarded 
(rightly) the idea of modifying the in- 
terleaving table, because DOS and 
diskettes thus created were incompat- 
ible with standard ones. They suggest 
to modify the physical sectors order, in 
such a way that 8 sectors lay between 
two logical consecutive sectors. It is a 
good idea, but it has some disadvan- 
tages. First, it requires to re-init the 
diskette. Second, the majority of copy 
programs, and the more reliable ones, 
will destroy the work and restore the 
standard sector order on the copy. 
Third, all that work can achieve only a 
45% gain in loading speed, in the best 
case. If we might read a sector every 
two, as in the DOS loading, we can 
achieve a much greater improvement. 
But this implies rewriting part of file 
manager. Well, if there is no other way, 
we must follow this one. 

There is a problem: after loading 
and decoding a sector, there is no time 
for copying it in memory at the right 
place. It were therefore necessary to 
read it directly in memory. But this is 



Figure 2: Approximate binary file loading limes (In seconds) 


File size 


Normal DOS 


Speedload DOS 


1K (1024 bytes) 


3.1 


2.5 


2K (2048 bytes) 


4.2 


2.7 


4K (4096 bytes) 


6.5 


3.7 


8K (8192 bytes) 


9.8 


3.9 


16K (16384 bytes) 


17.6 


5.7 


32K (32768 bytes) 


32.3 


8.3 
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not ever possible, as some sectors are 
only partially written and imwanted 
bytes must not be placed in memory. 
Looking closer at the file structvire, it 
can be seen that only the first and the 
last sector does not contain only bytes 
to be copied in memory. The first 
because it begins with address/length 
informations and the last if it is not ex- 
actly filled (which is unlikely to hap- 
pen) . All the sectors in between can be 
loaded directly in memory without any 
problems. 

That is the theory of SPEEDLOAD: 
loading the first sector in the normal 
way, loading all the subsequent ones 
directly in memory, excepted the last, 
if it is not wholly filled. Obviously, 
there is no gain in loading a very short 
file and in preliminary operations (in- 
dex looking, etc.), but there is a great 
speed improvment as the file size grows 
up, as you can view from figure 2. Since 
SPEEDLOAD trick is in the DOS, it do 
not requires any modifications on 
diskette formatting and can read any 
standard diskette. The modified DOS 
can be put on the diskette and it will be 
booted exactly as the standard DOS. 
Let us go to the practical implementa- 
tion of SPEEDLOAD. 

Inside The File Manager 

Since SPEEDLOAD must deal with 
Basic and binary files, we need to look 
closely at the loading process. The in- 
volved commands are LOAD, BLOAD, 
RUN and BRUN. First, notice that 
RUN and BRUN make use respectively 
of LOAD and BLOAD routines, so we 
can look only at the latter ones. Let's 
look at the DOS loading process: 

- External level calls file manager for 
reading file informations: loading ad- 
dress and length for binary files, length 
only foi Basic files. 

- External level calls file manager for 
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reading a block of bytes of specified 

length. 

- External level sets required 

parameters and, if needed, starts the 

loaded program. 

In all loading operations, file 
manager make use of the formerly 
outlined RDIBYT routine. But for 
loading a block RDIBYT is called 
through a "read L bytes" (RDLBYT) 
routine which sets L (the required 
length) and jumps in a general purpose 
routine (read/write a range of bytes). It 
is therefore possible to alter this jump 
and redirect it to a hi-speed block 
loading routine. 

Since the 48K slave version of DOS 
3.3 is universally accepted, I decided to 
make SPEEDLOAD not relocatable, 
thus keeping it smaller. 

After a careful analysis (using 
some DOS sources and the Quality 
Software's Beneath Apple DOS], I 
determined the input parameters and 
conditions of RDLBYTE. These are 
outlined in figure 3. The new routine 
must respect these conditions in order 
to maintain compatibility with stan- 
dard DOS. 

The SPEEDLOAD routine 

The SPEEDLOAD routine is very 
little structured, because speed is 
needed. There are only 2 msec (or little 
more) available between RWTS calls. 

Figure 4 is the listing of 
SPEEDLOAD routine, (in LISA 2.5 for- 
mat). Notice the assembly address: the 
SPEEDLOAD routine take the place of 
the DOS 3.3 FORMAT routine, that is 
the routine which physically initializes 
a new diskette, writing the address 
marks on it (and empty data too). The 
FORMAT routine is therefore no more 
available, but this do not means that it 
is impossible to INIT a diskette. Since 
the INIT routine is not modified, it is 
always possible to re-INIT a previously 
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Figure 3: RDLBYT input variables (for 48K siave DOS). 
Ali 2'byte variables are in the L'H order. 

i\Aemory locations: 



Loc. Name Contents and/or meaning 



$03 ' READ (FMNGR opcode) 

$02 = R/W RANGE (FMNGR 

subcode) 

Record index. In practice, position in 

file $ 1; it is $01 if Basic file, $03 if 

binary. 

Byte offset In the record; always 0. 

No. of bytes to read (FILEN) 

Before jumping to SPEEDLOAD 

routine. It will contain the loading 

address (now in Y,X) 

FIVINGR return code 

Not used 

Address of FMNGR worl< area buffer 

Address of T/S list buffer, which 
contains the first T/S list sector 
Address of sector buffer, which 
contains the first data sector 



A: don't care 

Y,X: loading address (H,L) to be stored In FMPAR + 6, + 7 

Zero page variables available: 

$42,$43 only. 



$B5BB 


FMOPC 


$B5BC 


FMSUBC 


$B5BD 


FMPAR+0 




FMPAR + 1 


$B5BF 


FMPAR+2 




FMPAR + 3 


$B5C1 


FMPAR + 4 




FMPAR+5 


$B5C3 


FMPAR + 6 




FMPAR + 7 


$B5C5 


FMPAR + 8 


$B5C6 


FMPAR+9 


$B5C7 


FMPAR + 10 




+ 11 


$B5C9 


FMPAR + 12 




+ 13 


$B5CB 


FMPAR + 14 




+ 15 


CPU registers: 



used diskette (if it is not damaged) . It is 
not possible to INIT a new diskette for 
the first time, because the routine 
which writes the address marks is no 
longer within DOS, A direct call to 
RWTS Format returns with a "format 
error" indication. 

A diskette must be INITed for the 
first time using a normal 3.3 DOS. 
After that, it can be re-INITed with 
SPEEDLOAD DOS, unless an un- 
wanted exposition to a magnetic field 
has destroyed the formatting. More in- 
formation about INIT in the next 
paragraph (installation). 

The routine is 257 (3101) bytes 
long. A more detailed analysis of DOS 
might have allowed to further reducing 
the routine size, making use of some 
DOS subroutines, but I preferred a self- 
contained routine. The only external 
call is for RWTS. You might be sur- 
prised to see a single zero page pointer 
(PTR in the listing) used alternately for 
two purposes, but I chose to use only 
locations used by the standard file 
manager routine, thus insuring total 
compatibility in any case. 

The DCM directive instructs the 
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assembler to save the produced object 
code under the name SPL.M. 

Installing SPEEDLOAD 

Once you have assembled the 
SPEEDLOAD routine, you must build 
a SPEEDLOAD DOS, following this 
procedure: 

— Boot a standard 3.3 DOS. 

— Put in a new (blank) diskette. 

— INIT the blank diskette. 

— Insert the diskette with SPL.M 

— BLOAD SPL.M, A$BEAP 

— Remove the diskette with SPL.M 

— CALL-151 (go to monitor) 

— A477: 4C BA BE (link SPL routine) 

— AE93; EA EA EA (unlink Format 
routine) 

— CTRL-C (return to Basic) 

— Put in again the blank diskette. 

— INIT the blank diskette again. 

You now have a diskette with 
SPEEDLOAD DOS on it. Transferring 
SPEEDLOAD DOS to another diskette 
can be achieved in two ways: 

1.) INIT a new diskette with standard 
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DOS, then boot SPEEDLOAD DOS and 
re-INIT the diskette. 
2.) Transfer tracks 0-2 from 
SPEEDLOAD diskette to normal 
diskette, using some copy program. 

The second way allows you to in- 
stall SPEEDLOAD without erasing the 
data on the diskette, if you have a track 
copy program. 

If you want to copy a SPEEDLOAD 
diskette, you can do it with COPYA, 
but the destination diskette must have 
been previously INITed with normal 
DOS, or you will get an I/O ERROR 
message. 

Conclusions 

Although there are many speeded- 
up DOS available on the market, 
SPEEDLOAD DOS is the only one, for 
that I know, which is fully compatible 
with normal DOS in inner addresses, 
POKEs, variable usage and so on. 
SPEEDLOAD works only in loading 
process, and that is its major limita- 
tion, but that is a constraint if you 
want to keep compatibility with DOS 
3.3 (and, beside that, I do not wanted to 
rewrite all the DOS). However, if you 
have a big program, or you made use of 
chaining or machine-language 
routines, SPEEDLOAD can save you 
lots of time, in program development 
and usage. 

I tested SPEEDLOAD with over 200 
programs and I do not found any in- 
compatibility, even with programs 
which make extensive use of the file 
manager, as FID or Microsoft's TASC 
compiler. I confess that I removed the 
protection system from many of my 
game diskettes, only for installing 
SPEEDLOAD and avoiding frustrating 
delays. I hope we do not have to see 
again the hateful "please wait while 
loading...", now that SPEEDLOAD is 
available. ilMCftO 

Biogzaphy 

After working five years in designing 
specialized circuits for FM broadcasting, 
I founded a little firm which is now 
growing in the Eviropean industrial 
micro-board market. Since January 1983 I 
work as free-lance piogrammer and 
writer (mainly for Jackson publishing 
group, based in Milan). My first interest 
in programming are high level multi- 
player games and didactical applications. 
I am responsible for small computers in 
ABRS (a research association) and 
ASTROFISMA (a didactical one for young 
people). I work with an Apple E, two 
drives and silentype. 
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FOR YOUR APPLE II 

Industry standard products at super saver discount prices 



SOFTWARE 

ARTSCI List SGC 

Magicalc $149.00 S 99.00 

Magicwindow 99.00 65.95 

Magicword 99.00 60.95 

Special, All 3 of above .. . 347.00 219.95 

BRODERBUND 

Payroll $395.00 $255.95 

Acct/Rec 395.00 255.95 

Arcade Machine 59.95 39.95 

Choplifter 34.95 24.95 

Sea fox 29.95 20.95 

Galaxy Wars 24.95 20.95 

DATAMOST 

Property Mgr $295.00 $194.95 

Real Estate 

Investment Package .... 179.95 118.95 

Tax Beater 129.95 89.95 

Zaxxon 39.95 27.95 

Casino 39.95 27.95 

Conquering Worlds 29.95 20.95 

Mating Zone 29.95 20.95 

Pandoras Box 29.95 20.95 

Series Baseball 29.95 20.95 

INFOROM 

Zorl<1,2, 3 $ 39.95 $ 27.95 

Planet Fall 49.95 32.95 

Starcross 39.95 27.95 

PEACHTREE 

Peachcalc $150.00 $ 92.95 

PeachPak(G1/Ar/Ap/) ... 395.00 226.95 

Mailing ListMgr 250.00 151.95 

SENSIBLE SOFTWARE 

Medical dictionary $ 99.95 $ 72.95 

DOS Plus 25.00 18.95 

Legal Dictionary ......... 99.95 72.95 

SIR TECH SOFTWARE 

Legacy of Llylgamyn ....$39.95 $29.95 

Wizardry 49.96 34.95 

Galactic Attack 29.95 21.95 

SIRIUS 

Bandits $ 34.95 $ 24.95 

Epoch 34.95 24.95 

Fly Wars 29.95 20.95 

Beer Run 29.95 20.95 

Outpost 29.95 20.95 

Snake Byte 29.95 20.95 

Sneakers 29.95 20.95 

Joy Port 49.95 37.95 

STRATIGIC SIMULATIONS 

Germany $ 59.95 $ 42.95 

North Atlantic 1986 59.95 42.95 

Rapid Deployment 

Force 34.95 25.95 

Road to Gettysburg 59.95 42.95 

Computer Baseball 39.95 32.95 

Computer Quarterback ,. 39.95 32.95 

Bomb Alley 59,95 42.95 

Napoleons Campaigns .. . 59.95 42.95 



SPECIAL AND NEW 

FRANKLIN COMPUTER 

With 48K RAM, 1 Disk Drive, Disk Controller Card, 
12" Amber Monitor, Additional 64K RAM, Magi- 
calc, Magicword, Magicwindow, Magicspeller 

Special Price $1949.95 

"New" from Prometheus Products 

ProModem® 1 200 Bell 21 2A 300/1 200 
Baud Modem 

A. Can be expanded into a telecommunication 
system as a stand-alone package. 

B. Real time clock and calendar 

C. Help Commands 

D. Built-in diagnostics 

E. Auto dialer 

F. Programmable Intelligent Dialing 

G. RS 232 interface 

H. Internal Power Supply 

OPTIONS 

On line phone directory 

Expandable buffer from 16Kto64K 

SPECIAL $ 475.00 

BASIS 108 
128K computer SPECIAL $915.00 

Also available with CPM 3.0 or DOS dual drives 
monitor, perfect series software or Magicalc, 
Magicwindow and Magicword. Call. 

PROMETHEUS PRODUCTS 

16KCard $ 60.00 

64K Expand-A-Ram $ 225.00 

128K Expand-A-Ram $ 275.00 

GraphittI Card 

(Specify Printer) $ 89.00 

P.S.16K Buffer Card 

Expandable to 64K $ 105.00 

Applesurance Card $ 99.00 

VersaCard Four cards in one 

1. Serial 2. Parallel 3. Real Time clock and 

calendar 4. BSR Port $ 159.95 

With Graphics $ 199.95 

PRT-1 Printer Card $ 79.00 

PRINTERS 
NEC 8023 $ 395.00 

with interface 

card and cables $ 449.00 

OKI 82A 

80col./120cps $ 439.00 

OKI 83A 

136col./120cps $ 695.00 

Brother 

Letter Quality $ 889.00 

Transtar315 

Color Printer $ 469.95 

ACCESSORIES 

T.G. Joystick $ 42.95 

SelectaPort $ 39.95 

System Saver Fan $ 69.95 

Super Fan 11 $49.95 

Slimline Disk Drives $ 225.00 

Disk Drives Full Ht $ 195.00 

Floppy Disc Box 10 $ 25.00 

Floppy Disc w/order $ 19.90 






BUSINESS SPECIAL 

Includes 80 Column Z-80 Card • 16K Card • 
Wordstar • Supercalc 

Special $795.00 

D.O.S. Programming SPECIAL 

80 column Card • Magicalc • Magicwindow • 

Magicspeller* 16K Card Special ....$449.00 

3-CARD SYSTEM 

80 C0I/16K card/Z-80 card Special .... $319.95 

MODEMS 

Smartmodem 300 $219.95 

Smartmodem 1200 $499.00 

D-Cat Modem $164.00 

MONITORS 

14" Composite Color High Res $260.00 

Amber 12" $129.95 

Taxan RGB color $395.00 

LISI Hi/Res green $141.95 

80 COLUMN CARDS 

Smartermll $149.95 

Videx Video Term $215.00 

Ultra Term $289.00 

View Master $139.00 

Apple lie 64K, 80 col $ 99.00 

Z-80 CARDS 

Microsoft Softcard $229.95 

Z-80 Plus $125.00 

Z-Cardll $131.95 

EDUCATIONAL SOFTWARE 

Spelling/Reading Primer $ 29.95 

Perception $ 20.95 

Counting Bee $ 23.95 

Word Scrambler $ 15.95 

Fractions $ 36.95 

Intro. Algebra $ 21.95 

BUSINESS SOFTliVARE 

Wordstar $244.95 

Spellstar $159.95 

WStar/MMerge $395.00 

WStar/SStar $422.00 

Supercal $129.95 

PSFFile $ 88.75 

PSF Graph $ 88.75 

PSF Report $ 88.75 

PSF3PAK $246.75 

All equipment shipped factory fresh. fWanufacturers' warranties 
Incluaea. California customers a(3d 6V2% tax. include payment by 
personal check, money order, or cashier's check with order and 
SGC will pay shipping charge. Call for amount of shipping charge 
when paying by credit card. 

All items are normally in stock 

415^490-3420 

. . , And we'll be here to help after you 

"A receive your order. Feel free to call the SGC 

\a Technical Staff for assistance. 

The mail order specialists 

342 Quartz Circle, LIvermore, CA 94550 




MICftO 



Product Name: Printmate 150G Printer 



Apple Reviews 




Equip, req'd: 

Price: 

Manufacturer: 



Serial, Parallel or IEEE interface 

7 

Micro Periphals, Inc. 

4426 Century Drive 

Salt Lake City, UT 84107 



Description: A high quality dot-matrix printer with bi- 
directional printing, true descenders and one-pass 
underlining capability, the 150G prints 100 CPS, 132 
characters per line and has a IK (expandable to 8K) buffer. 
While printing normally with a 5 x 9 dot matrix, a serif 
font is included for letter quality type in a 11 x 9 matrix. 
Dot addressable graphics are supported, and an Ap-pak is 
available for Apple owners with full software support for 
screen dumps including different sizes, alignment and 
printing two pictures at once. Special fonts may be down 
loaded into RAM or stored in ROM. An optional external 
keypad is available for setting printer options and is 
backed up with a battery for remembering the settings. 

Pluses: A very fast, very high quality printer which makes 
the imported models pale in comparison. If you want a 
better quality printer at a comensurate price, this is the 
printer I recommend. I have used it for all my printing for 4 
months and have not had a single problem. 

Minuses: None. 

Documentation: An 80h- page technical manual and a 
50 + page Ap-pak reference manual are included. They are 
terse, well written manuals. If you like chattiness, buy 
an import. 

Skill level required: No prior knowledge necessary. 

Reviewer: Phil Daley 



Product Name: Money Tool 

Equip, req'd: Apple II + or He, disk drive, printer 

Price: $59.95 

Manufacturer: Howard W. Sams & Co., Inc. 

4300 W. 62nd St. 

Indianapolis, IN 46268 

Description: This product is an excellent checkbook/ 
budgeting program. It is set up to automatically categorize 
expenses and apply them against deposits. Additionally, 
features are provided to accommodate payroll deduction 
storage for end-of-year tax accounting. 

Pluses: The program is incredibly fast for what it has to do. 
Categorized summations are available for any desired time 
period. Hard copy is neatly structured and easily interpreted. 



Minuses: The program is overpriced. I've seen similar 
home finance utilities for half as much. Functionally, the 
only feature I found offensive was the inability to display 
on the screen all the reports that could be printed. 

Documentation: The documentation is entirely adequate. 
The tutorial is written clearly and is easily followed. Do- 
ing so, one can learn everything in about two sittings. 

Skill level required: A new Apple owner would have no 
problem using the program. 

Reviewer: Chris Williams 



Product Name; Apple Record Manager 

Equip, req'd: Apple n or IIh- with one disk drive 

and 48K 
Price: $40.00 

Manufacturer: Connecticut Info Systems 

218 Huntington Road 

Bridgeport, CT 06608 

Description: Creates and saves text files, which you can 
then edit, append, rename, or delete. This Menu-driven 
program allows you to set up sequential data files of 
variable length. You name the files and fields and can 
quickly view /edit data prior to printing or saving. 

Pluses: One-keystroke commands make operation smooth 
and simple. A quantity of utilities perform all needed func- 
tions from the menu. 

Minuses: Error-handling is only marginal and might trip 
up beginners. The screen often becomes cluttered as 
Record Manager is a stripped-down package and skimps on 
niceties, such as screen formatting. 

Documentation: No written instructions are provided, but 
upon booting the disk, on-screen instructions are 
displayed, and they are satisfactory for acquainting the 
user with information needed to operate the program. 

Skill level required: Some knowledge of text files is useful 
but not mandatory. After some stumbling around, a begin- 
ner will get the hang of things. 

Reviewer: Mike Cherry 



Product Name: Micro Illustrator 

Equip, req'd: Apple 11 w/48K and Applesoft 

Recommended: Koala Touch Tablet 
Price: $129.95 with Tablet 

(continued) 
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Hewlett Packard 

Write or call for prices. 



m 



10/5.45 
10/5.95 
8 for 14 
6.00 



SPECIALS on INTREGATED CIRCUITS 

6502 7.45 10/6.95 50/6.55 100/6.15 

6520 PIA 5.15 10/4.90 50/4.45 100/4.15 

6522 VIA 6.45 10/610 50/5.75 100/5.45 

2716EPR0M 4.45 5/4.20 10/3 95 

2532 EPROM 5.90 5/ 5 75 

61 1 6 2KX8 CMOS RAM 6.45 5/ 6.20 
4116 RAM 

4164_RAM 

Anchor 
Automation 
Signalman 
Modems 

FREE SOURCE MEMRERSNIP WITH SIGNALMAN 

All Signalman Modems are Direct Connect, and provide the 
t)est price-performance values. 

Dealer and OEM inquiries invited 
Volksinodem witli camputer cable |99] 68 

Mark VI for IBM Personal Computer (279) 139 
Mark VII Auto DIal/Auto Answer (159) 99 
Mark XII Smart Model 1200/300 (399) 299 




OC HAYES Smirtmodem 

DC Hayes Smartmodem 1200/300 



219 

529 



PROM QUEEN lor VIC 

Apple Emulilor for Commodore 64 

STAT Stillstics Picltiiie lor C64 

Solid Oik 2 Level Stand lor C64 or VIC 

C64/VIC Switcti (networking) 

BACKUP VI. tape copier lor C64 or VIC 

CARDBOARD/6 Mothertjoard - VIC 

CARDBOARD/5 Motfierboard - C64 

CARD PRINT G Printer Inl with Graphics 

CARD PRINT B Printer Interface— C64/VIC 

CARDB0ARD/3S Motherboard - VIC 

CARDCO C64A'IC Calculator Keypad 

CARDRAM/16 RAM Expansion - VIC 

Complete CARDCO Line In stock 

CIE and VIE IEEE Interfaces in stock 

MSn SuperUiln lor C64 or IEEE 

MAE Assembler for C64 

Koala Toncli Taklat— C64 or VIC 

CBC 4/1 2 1 Z-bIt A to D Bean! + Soltware 

Multjplan lor C64 

Dust Cover lor C64 of VIC 



170 
Call 
95 
29 

129 
20 

64 
56 
72 
40 
22 
32 
44 



365 
50 
79 

199 

79 

6 



APPLE— FRANKLIN ITEMS 



FRANKLIN— complete line In slock 
QUENTINDriies lor Apple/Franklin 
Swapper Stopper 

automatic switch between paddles and joystick 
KRAFT Apple Jorstick 
Kraft Apple Paddle Pair 
Koala Touch Tablet-Apple/Franklln 
SPINNAKER Saltwate In stock 
Broderlund Software in stock 
16K RAM Card for Apple 
Mvltlplan— MIcnisolt 
Solid Oak 2 Level Stand lor Apple 
Serial Card for Apple 

MCP AAM/80 columa card lor lie |AP/TXT| 
Z80 Softcard and CP/M (Microsoft) 
RANA Elite I with Controller 
Parallel Printer Interlace/Cable 
Micretak a«4 MCP Interfxes in stock 
Grappler + Interface 
Kraft Products for Apple in stock 
DC Hayes Micromodem II 
PFS: File 
PFS: Report 
Videx 80 Column Card 
Apple Blue Beak 



219 
26 

40 

30 
90 



59 

185 

29 

89 
139 

235 

389 

69 

129 

299 
95 
95 

209 
19 



B commodore 

See IIS for Personal Business, and Educational 
tBquirenwnti Educatiensl Discounts available. 

PETSCAN I $245 base price 

Allows you to connect up to 30 CBM/PET Computers to 
shared disk drives and printeis. Completely transparent to the 
user. Perfect for schools or multiple word processing con- 
figurations. Base configuration supports 2 computers Addi- 
tional computer hookups $100 eadi 



CQMPACK/STCP 



$115 



Intelligent Tenninai Paeliage for PET. CRM, C64 

Includes ACIA_Hardware /_SJCP Software 

SCREENMAKER80ColuninAda||terf«rC64 145 

Provides big screen capability for business applications 

GENESIS Computer Carp 

VIController (for C64 as well) 50 

combine with BSR modules fof home or business control 

COMSENSE flemeteSansia|AdapterforC64orVIC 35 

COM VOICE Syntbesizer for C64 or VIC 1 39 

includes software for text to speech, pitch, etc. 

COM CLOCK fleal Time Chick with battery backip 45 



VlCZOPreductssadSoftwaralaitack 




Thwi EMI Seftwara UMI Saltware 




ABACUS Seltwara HES Saltware 




16K RAM fof VIC 64 Vanilla Pilot 


27 



VICTORY Software for VIC and C64 

Metamorphosis 16 Creator's Revenge 



Labyrinth of Creator 
Kongo Kong 
ChomperMan 
Bounty Hunter 



16 
16 
16 
16 



Galactic Conquest 
Annihilator 
Grave Robbers 
Adventure Pack I or I 



16 
16 
16 
13 
16 



PAPER CLIP Ward Ptecessor 99 

ORACLE Oata Base tram Batteries Included 1 09 

Super BusCard ftem Batteries Included 1 59 

Commodore 64 Programmers Reference Guide 1 6 

MicniCboss for C64— 8 levels of play 1 9 

excellent graphics and color 
SPINNAKER Software C64. Apple, IBM, Atari 

Computel's First Book of PET/CBM 1 1 

C64 or VIC SWITCH 129 

POWER ROM Utilities for PET/CBM 78 

WordPro 3+/64 with Spellmastar 85 

WordPro 4-H - 8032, disk, printer 295 
SPELLMASTER spelling checker ler WordPro 

VISICALC for PET, ATARI, of Apple 189 

PET-TRAX PET te Epsen Graphics Software 40 

SM-KIT enkaacad PET/CBM ROM UIMHIes 40 

Programmers Toolkit - PET ROM Utilities 35 

EASY CALC for C64 65 

PET Spacemaker II ROM Switch 36 

COPYWRITER Word Processor lor C64 69 

2 Meter PET to IEEE or IEEE to IEEE Cable 40 

Dust Cover for PET, CBM, 4040, or 8050 8 
CmC Interfaces (ADAI800. A0AI450. SADI In stock) 

Pregrammlag the PET/CB M (Coaiputd) — A. West 20 

Computei's Machine Language for Beginners 1 1 

MULTIPLANIorC64 79 

HES MOOEM with Software 65 
HES Software aad Hardware la stock 

UMI p reducts la slack 

FlexFile for PET/CBM/ C64 $ SO 

Datatase^ReportJWnta_withca(ci^^^ 

FORTH for PET/C64 full FIG model - CargiliyRiley $50 
Meticaapilor ler FORTH for independent object code 30 

KMMM PASCALTv.1 tit PET/CBhl7c64 M 

EAB L far PET/CBM Disk-b as ed ASSEM BLER 65 

Super Graphics — BASIC Laagiage Exteaslans 45 

Fast machine language graphics routines for PET/CBM 

HAM/ROM for PET/CBM 



4K$75 8K $90 



DISK 
SPECIALS 




Scotch (3M) 5" ss/dd 
Scotch (3M) 5" ds/dd 
Scotch (3M) 8" ss/sd 
Scotch (3M) 8" ss/dd 



10/2.20 50/2.00 100/1.95 

10/3.05 50/2.80 100/2.75 

10/2.30 50/2.10 100/2.06 

10/2,85 50/2.70 100/2.65 



We Stock VERBATIM DISKS 

Write for Dealer and OEM prlcei 

Sentinal 5" ss/dd 10/1.90 50/1.85 100/1.80 

Sentinal 5" ds/dd 10/2.55 50/2.50 100/2.45 

We stock Dysan disks 

Wabash 5" ss/sd 
Wabash 5" ss/dd 
Wabash 8" ss/sd 



10/1.60 50/1.55 100/1.45 
10/1.90 50/1.85 100/1.75 
10/2.00 50/1.95 100/1.85 



We stock MAXELL DISKS 

Write for dealer and OEM prices. 

Disk Storage Pages 1 for $5 Hub Rings 50 for $6 
Oisk Library Cases 8"— 3.00 5"— 2.25 
Head Cleaning Kits 12 
AMARAY Disk Storage Systems in stock. 
Innovative Concepts FLIP 'N' FILES in stock. 



CASSEHE TAPES— AGFA PE-On PREMIUM 

C-10 10/ .61 50/ .58 100/ .50 
C-30 J^'P 50/ .82 100/_70 

DATASHIELD RACKUP POWER SOURCE $265 

Battery back up Uninterraptible Power Supply with surge and 
noise filtering. The answer to youj^power problems. 

MeltlPlaii— IBM or Apple IBS 

Quadboard for IBM available 

KOALA Touch Tablets— Apple, Atari, IBM, CBM 

PcKbleit 5000 Software Package 209 

PFS Software for IBM and Apple in stock 

VOTRAX Personal Speech System 280 

BMC 9191 CohirMoonor 229 

BMC 12A 12" Green Monitor 79 

Bratber HR-75 Daisy Wheal Pitnter 769 

Dyeei (Brelheit DX-1 5 Daisy Wheel Printer 469 

Itoh Prowriter Parallel Printer 379 

Paeasoaic 1 090 Printer with Comspoodeoce Mode 279 

Daisywriter 2000 with 48K buffer 1 020 

GamhiliaX 299 

EPSON, Okldala, Star MIcrenlcs printers In stock 

USI CompuMOD 4 R F Modulator 29 

We Stock AMOEK Monitors 

AmdekDXY-1 00 Plotter 590 

A P Products 15% OFF 

COMPUTER COVERUPS IN STOCK 

BROOKS G Oitlet Sorgo Suppressor/Noise FUter 54 

Surge Suppressor-6 outlet 29 

Electrohome 1 302-2 1 3" Hi-res RGB Monitor 335 

Panasonic 1 2" Monitor (20 MHz) with audio 1 35 

Syaertek SYM-t Micncamputer 189 

USI Video Monitors— Green or AMBER 20 MHz hi-ns. 
Dealer aod OEM laqallries lawted 

YgMiigt I data 

I systems 



ZVM-122A 109 ZVM-123G 


95 


ZVM-131 300 ZVM-135 


510 


HERO 1 Robot (factory assembled) 


2145 


Z29 Terminal (DEC and ADM compatible) 


680 


ZT-10 Intel. Terminal with Serial Port 


340 


2100 16-tBt/8-bit Systems 


CALL 


We stock entire Zenith line. 





ATARI — WE STOCK ENTIRE LINE 

SPINNAKER and Broderbund Software in Stock. 



215-822-7727 

252 Bethlehem Pike 
Colmar, PA 1891 5 



A B Computers 



WRITE FOR CATALOG. Add $ 1 50 per order for United Parcel 
We pay balance of UPS surface shipping charges on all prepaid orders 
(add extra for mail, APO/FPO, air) Prices include cash discount 
Regular prices slightly higher Prices subiect to change 



=: Apple 

Manufacturer: 
Author: 



Koala Technologies 
253 Martens Ave. 
Mt. View, CA 94040 
Steven Dompier 



Product Name: Bugbyter 



Description: A graphics illustrating program with various 
brush sets, colors, and drawing modes. Points, lines, rec- 
tangles and circles can be plotted on the high resolution 
screen with different colors. Filling and erasing is ac- 
complished easily. Creations can be saved to and loaded 
from disk. The program is a combination of BASIC and 
machine-language on an unprotected disk. 

Pluses: The program is menu driven and much easier to 
use than most graphics programs. It includes many 
sophisticated features such as magnification and fill. It is 
very easy to create complicated and professional look- 
ing drawings. 

Minuses: The Koala Tablet is recommended for its 
smoothness and preciseness. It is difficult to draw a 
smooth line with a joystick. 

Documentation: A very complete, clear and well written 
booklet is included with the program. 

Skill level required: No prior skill needed. Good for ages 5 
and up. 

Reviewer: Phil Daley 



Equip, req'd: 

Price: 

Manufacturer: 



Author: 



Apple II 

$47.50 

Computer-Advanced Ideas 

1442A Walnut Street, Suite 341 

Berkeley, CA 94709 

Tom Cohn, and Pete Row 



Description: Bugbytei is an interactive M/L debugging 
tool which is relocatable to any unused location com- 
patable with your program including into a language card. 
It has a screen-oriented display which has complete infor- 
mation on the status of all the 6502' s registers and stack. It 
includes capabilities to turn off the display to avoid con- 
flict with the program, and to set an area of memory (such 
as DOS or the monitor) to be executed at real-time known 
code. You can set breakpoints-hard or soft-and triggers to 
count the break points. It assembles and disassembles 
code similar to and uses instructions like the monitor. The 
accompanying 40 page documentation is excellent. 

Pluses: It is very easy to use and clearly shows everything 
you need for debugging. No M/L programmer who writes 
large programs should be without it. 

Minuses: None. 

Skill level required: Beginning to intermediate M/L 
programmer. 

Reviewer: Phil Daley ^MOIO 




SOFTWARE ENHANCEMENT 

SYSTEM. APB-102 S189.00 

W/GPLE, APU-1, FMP, DISK, 

MANUAL, QUICK REFERENCE GUIDE 
APU-2, tminY ROM *2 $35.00 

W/RENUMBER, MERGE HOLD, ETC. 
ROM DEVEIOPMENT PKG $99.00 

W/DISK, INSRUCnONS «, 

EMULATION ROM 
A/0, 12 BIT, 16 CHANNEL $299.00 

W/5 VOLTAGE RANGES, 

25 (J SEC CONVERSION 
PRO-1. XTRA-LAKGE PROTOTYPE 
BOARD S29.95 

UP TO 52 IC's. NUMBERED & 

LETIERED PINS, HANDY POWER 

AND GROUND CONNECTIONS. 

NUMBERED I/O CONNECTIONS 
48 LINE PARAI.IFT I/O 
BOARD, CPU-1 S249.00 

25 BUFFERED UNES IN 

W/FILTERING, 23 

BUFFERED UNES OUT. 

INTERRUPT INPUT 



* 



#1 SELLER AT A.P.P.LE 

Powecftd New Softwate Enfiaticemeiit System 
ForRppie 11, //e, TrfpfesProgrammiiu; Speed! 

APB-102 Ultta-Rom Boatd/Editor Includes: 

• Advanced G.P.LE.* (flobal Program Line Editca-) in FimTware 

—With Insert, Delete, Hnd, Tab, Zap, Pack, Restore, End, Etc. 

• Rrmware Management Program (FMP) Overiays 32K of ROM in 2K Space 
— ^Allows jumps and calls between banks — searches for utilities by name 
— Recognizes new ROMs and utilities automaticallY 

• APU-1 with over 25 Language Ejctensions & Ampersand Utilities 

— If/Ihen/Hse, Print Using, Ultra Fast Search, Damaged Program Recovery 

• Always in the Machine — No Searching for a Disk 

• Never in the way — No Program RAM used 

— Connect with 4 Keystrokes / Disconnect with 2! 

"If iKiu program & haven't used a tine editor, get one right away" — MICRO MAGAZINE 

"The most powerful program deuelopn\ent tool I have" —ROBERT WILSON, PROGRAMMER 

"Excellent Product, flawless" —PHILIP DALEY, PROGRAMMER 

"Great product, exceeds m),/ expectations" —DR. STEVE COOK 

"An elegant solution... well thought out... worth it" — SOFTALK REVIEW, SEPT. 1983 

"The best thing for the Apple since the disk" —EDWARD DECKER. PHARMACIST/PROGRAMMER 



Hollywood Hardware (213) 989-1204 

6842 VALJEAN AVENUE, VAN NUYS. CA 91406 



USE OUR 60 DAY UNCONDmONAL MONEY BACK TRIAL 
IF YOU CflN PART WITH IT— \WE'U BUY IT BACK! 

ASK ABOUT DEALERAISER GROUP DISCOUNTS! 

• G.P.LE =1983 NEIL KONZEN. SOLD UNDER UCENSE FROM SYNERGISTIC SOFTWARE / APPLE IS A REGISTERED TRADEMARK OF APPLE COMPOTES INC. 
A.P.PLE. IS APPLE PUGETSOUND PROGRAM UBRAKY EXCHANGE, THE WORLDS LARGEST APPLE USERS GROUP WITH 25,000 MEMBERS. 
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SJB DISTRIBUTORS. 

ONE STOP SHOPPIIMG FOR 

COMMODORE SYSTEMS. 



B commodore 

NEW COMMODORE PRODUCTS 

Executive 64 $ Call 

CBMB128-80 825 

B Series Software Call 

WORD PROCESSING 64 E 

NEW - Mirage 80 col $ 95 

WordPro 3VSpellrlght 79 

WordPro 3* (WP) 59 

Spellright (Dlctlonory) 39 

Paper Clip 95 

Easy Script (D) 35 

Easy Spell (D) 19 

SPECIAL - Busiwriter (CD) 39 

Quick Brown Fox (R) 49 

SPREADSHEETS 64 Z. 

Calc Result - Advonced (R,D) $ 120 

Busicalc II - More Power! (R,D) 95 

Multiplon 64 (D) 79 

Calc Result - Easy (R). 70 

Practicalc 64 (D) 45 

Busicalc I - SPECIAL! (CD) 39 

DATA BASES 64 Z 

Mirage Data Base (D) $ 95 

M'File (merges witti WordPro) (D) . . . 89 

Micro Spec Data Manager (D) 60 

Codewriter (develops programs)(D). . . 95 
PRODUCTS OF THE MONTH 

TCS 64/80 - NEW! (D) $ 139 

(WP/Dofo Base/Spread) 

Koala Pad - NEW! 89 

Delta 10 (160 cps)- NEW! 549 

UTILITIES 64 £ 

Vic Tree (4.0 Basic) (R) $ 75 

64 Super Expander (R) 25 

Simon's Basic (R) 25 

Cardco Printer Utility (C) 15 

MS-Backup (Back Up Data!) (D) . . . . 15 
ACCOUNTING 64 £ 

Home Accountant (Continental) $ 75 

Tax Advantage (merge w/tiome 

accountant) - NEW! 45 

General Ledger, A/R, A/P, P/R, Inv. 

(Info Design's Original) (D) ea.79 

Numeric Keypad (Hardware) 65 

Numeric Keypad (Cardco) 35 

TELECOMPUTING 64 E 

Vic 1650 (Auto Ans/Diol) Modem ... $ 95 

Vic 1600 Modem 59 

Hes Modem (Downloading Softwore) 65 

Super Term (Download/80-1 28Fonn). 95 

Micro Term 64 (Download P/D) 39 

EDUCATION 64 £ 

Spelling I (Koala) (D) $ 29 

Geometric (Koala) (D) 20 

I. Q. Baseball (D) 25 

Bible Baseball (D) 25 

Happy Tutor (Typing) (D) 15 



LANGUAGES 64 £ 

Instaspeed Basic Compiler (D) $ 99 

Nevada Cobol (D) 55 

Pilot (D) 45 

Logo (D) 45 

Assembler Development (D) 25 

64 Forth (R) 40 

PRINTERS - DOT MATRIX 

Epson RX80 (80 cps) $ 299 

MX80 w/FT (80 cps) 399 

FX80(160cps) 549 

FXlOO (160 cps) 14" width 859 

Okidata 82A 429 

Okidata 92 549 

NEC 8023A 429 

Stgr Delta (1 60 cps)-NEW! 549 

Star GeminilOX (120 cps) 309 

Star Gemini 10/15 Call 

Transtar 315 (Hi Res., Color) 575 

Micro Edge Printer Paper (540 Sheets).. 10 
ESSENTIALS 

Commodore 64 $ Call 

1541 Disk Drive 249 

1 525 Printer (80 col/DM) 225 

1530Datasette 65 

1 520 Plotter/Printer (4 Color) 1 69 

1526 Printer Call 

1702 Monitor 249 

CBM 

8032 (80 column Pet) $ 625 

SuperPet (5 languages!) 1049 

8050 Dual Drive (1 mg.) 995 

8250 Dual Drive (2 mg.) 1 295 

9060 Hord Disk (5 mg.) 1995 

2031, 170K Single Drive 295 

64K Upgrade tor 8032 259 

SuperPet upgrade tor 8032 599 

4023 Printer (80 cps, 80 col) 395 

8023 Printer (150 cps, grophics).... 545 

6400 Printer (40 cps, LQ) 1450 

LETTER QUALITY PRINTERS 

Diablo 620, 25 cps $ 949 

Transtar 1 30, 1 6 cps - 1 32 col 769 

Transtar 1 20, 1 4 cps - 80 col 500 

MONITORS 

Panasonic CT 160 (color) $ 279 

Panasonic TRl 20 (w/spkr,green) 1 55 

Sanyo /Amdek -Green, No Audio, 12"... 1 25 

BMC/Sanyo-Green, No Audio, 9" . . . . 95 

Coble (For Above) A/V 15 

VIC ACCESSORIES 

8K RAM Expand. Cart $ 40 

16K RAM Expand. Cart 70 

24K RAM Expand. Cart 105 

27K RAM (Expands Vic to full 32K). . . . 119 

3 Slot Expander. 30 

6 Slot Expander 70 

Joystick (Wico-Red) 25 

Joystick Blaster (ADR Rapld-Fire) .... 10 



INTERFACES & ACCESSORIES 

Data 20 80-Col. Exp $ 159 

Mr. Computer 80-Col. Exp 60 

5-Slot Exp. (64) 65 

Vic Switch (connect 8 64's or Vic's 

to DD/Printer) 145 

Cobles 3M, 6M, 1 2M for above Coll 

Verex (Box of 10) 5V* Diskettes 26 

Connection(Pet/64 graphic$,2K Buffer) 99 

Cardco Print ♦ Graphics 85 

Cardco Cordprint 70 

MW 302 Porollel 65 

PET/IEEE Coble (Im) 33 

IEEE/IEEE Coble (Im) 49 

Interpod (Intelligent IEEE, 

RS232, serial) 149 

ADA 1 800 (IEEE/Parallel) 1 29 

ADA 1 450 (IEEE/RS232 (M/F)) 1 29 

VISA/MASTERCARD 

MONEY ORDERS 

BANK CHECK 

CO.D.'s Accepted. (Add $5) 
In stock items shipped within 48 hours. 
F.O.B. Dallas, Texas (Texas Res., Add 5% Tax). 
Products shipped with manufacturer's warranty. 
Prices subject to change without notice. 
$50 Minimum Order. 

'Defective units must have return 
authorization number and include 
copy of invoice. 




SJB DISTRIBUTORS INC. 

10520 Piano Road, Suite 206 
Dallas, Texas 75238 

TO ORDER 

CALL TOLL FREE 

800-527-4893 

800-422-1048 

(Within Texas) 



CATALOG 

Send Postcard with Nome & Address to 
speed processing. 



NOTE: SJB HAS A FULL LINE OF COMPUTER MEDIA IN STOCK, CALL OR WRITE FOR MORE INFORMATION. 
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Interface Clinic 



by Ralph Tenney 



Dave English, of Orange, California 
wrote with the following ques- 
tion: "I have never seen a general 
treatment of direct interfacing between 
micro CPUs, so that one runs foregroimd 
and one runs background. This does not 
seem to be a difficult topic, as there are a 
variety of plugin modules are sold for 
various computers and other microcom- 
puters with dual CPUs, such as the 
SuperPET." 

Dave then goes on to mention one of 
his own experiments: "I currently have a 
Timex 1000 and a PET 2001 sharing the 
screen of the PET. It's not true time shar- 
ing; one or the other has complete con- 
trol of the screen at any time." 

We can address part of Dave's ques- 
tion by examining the factors involved in 
getting two (or more) CPUs to cooperate 
in various ways. The first tViing is to 
define the extent of the interaction and 
decide what type of interface is needed. 
We also need to understand that not all of 
the plugin boards sold for computers 
such as Apple are multi-processor setups, 
even though they may seem to be. Many 
of the popular "appliance" computers 
have a special input line in their expan- 
sion port to disable the processor so that 
an external plugin can take command of 
the memory. So, as long as that plugin is 
in place, only the processor on the plugin 
is active. I think it is fair to say that this 
setup doesn't really fit Dave's topic. 

There are two basic types of multi- 
CPU interfaces — one is where the 
various CPUs communicate directly on a 
shared bus, and, strange as it may seem, 
this can be done even with dissimilar 
processors. It is perhaps more convenient 
to do both the programming and the in- 
terface design if the shared-bus concept 
uses identical processors, but mutual 
operation on a shared bus is possible with 
different processors. The second mode is 
one where the necessary communication 
is carried on an auxiliary bus such as an 
RS-232 link or a high speed synchronous 
or asynchronous line. This type of com- 
munication can also be performed by 
.s imil ar processors (such as two 6502s) 
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or different processors [such as 6809 
andZ-80). 

During this discussion we will ignore 
those microprocessor famiUes which 
have coprocessors available; a 
coprocessor is a specially programmed 



subset of the main processor, dedicated 
to a special task such as number crunch- 
ing or I/O. These are a special case, 
and the interaction has been carefully 
planned by the manufacturer. We will 
also not deal with the concept of multi- 




NO POWER SPIKES 
WITH SUPER FAN II. 



Super Fan II's Zener Ray™ Transient 
Voltage Suppressor and Power 
Filter squelches spikes up to 6000 
amps — even those caused by 
lightning— while responding up to 
100 times faster than Apple II's 




built-in suppressor. 

In addition, Super Fan II cools 
your Apple, removing heat buildup 
at a remarkable 17 cubic feet of air 
per minute. Yet it's the quietest, 

fan of its kind on * ' 

the market. 

Super Fan II 
also positions a 
lighted on/off 
computer switch 
and two accessory 

plugs at your fingertips. It's warranted 
for two years and simply clips to 
your Apple II, He or monitor stand. 

See your R.H. Electronics dealer 

today about Super Fan II* or contact 
us at 566 Irelan Street, Buellton, 
CA 93427, (805) 688-2047. 

RHELECTRONICS, INC. 




Super Fan II, m black ^ ._ 
mmoul Zener Ray. 574.95. 
AddluonaJ air How seals, S5- 
Avarlable in 240^150 Hz 



Oealer/OEM Inquiries Invited. 
•U.S. Patent HD2682S3 
H43S3286 



France, call B.I.P (-255-4463 
Australia, call Imagineenng (02}212-IAn 
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Gee whiz. Look what you've done. 
Your big shiny Apple, destroyed. 

And you thought you were just having 
a little fun? 




Introducing our ^ < 

new home computer game * 
Cavern Creatures.™ Where one false move, one 
mistaken twitch of the Joystick can do terrible 
things to an Apple. Like shut parts down. 

Who knows which ones? Making it act 
awful funny and then . . . KA-BOOM! 



The game's finished. And maybe, so is 
your Apple. Oh, but don't worry 

Cavern Creatures is just a game. Full of action. 
Fun. Suspense. Just like our other games. 
Whether they're blowing up your Apple. 
Or totally blowing your mind. 

How Much More Can One Joystick Jockey Take? 

We've exceeded our past reputation for 
bringing you some of the most super snazzy 
ultra-intense, graphically involving games around. 

We've gone totally out of our minds with every 
game from shoot 'em up, blast 'em out of the sky 
strategies to mind game graphics guaranteed to 
provoke a mental meltdown. 

Are you ready? 



Cavern Creatures'" 

You can squirm. Beg. Plead. 
And moan. Nothing will save 
you, or your Apple, from being 
blown sky-high by this game. 
Don't worry. The effect's not per- 
manent. Your Apple will recover. 
But will vou? 




* ^ 




your Apple. 




space Ark'" 

Skin-hunters, poachers and 
mechanicals— enemy robots who 
aren't exactly the warm and 
friendly types— await you. Oblite- 
rate the bad guys. Save the good 
guys. You might survive this. 

Ardy The Aardvark'" 

Here's a tongue that's as long 
and skilled as you are. Think you 
can lick stinging ants and taran- 
tulas? Use Ardy's tongue as you 
make it through this maze! 

Roundabouf 

Sharpens your target skills 
with 24, count 'em, 24 different 
series of targets. How's your 
hand to eye coordination, pal? 

Argos'" 

And if you like to push people 
around, lay off your little brother 
and take on these aliens instead. 
Save the Domed City from 
doomsville. 




Super Bunny'" 

No, Super Bunny is not 
referring to all those Playboys 
stashed under the bed. It's a 
strategy /action game that just 
might turn your brains into car- 
rot puree. Cover your burrow! 

Conquering Worlds'* 

So you fancy yourself a die- 
hard strategist? Try conquering 
this. Maybe you'll rule the uni- 
verse if mom will let you off 
restriction. 

Bilestoad™' 

Avoid violence, but be prepared. 
Incredible graphics make this 
rated R! But if you're a wimp, pass 
this game up. It's not for babies. 



IDATAMOST 

The most out of our mindsr 

TM is a registered trademark of Datamosc. Inc. 8943 Fullbright Ave., Chatsworth, CA 91311 
(213) 709-1202 'Apple is a trademark of Apple Computers. © Datamosc 1983 



pie processors for the purpose of reliabil- 
ity [redundant design) . Instead, I will give 
some points to consider and hints on 
how to proceed with designing a system 
of multiple processors which share the 
system resources but each "does its own 
thing". One example is a commercially 
available dedicated word processor. In 
this particular system, a 6800 handles all 
the word processing while a 6502 runs 
the keyboard, screen display and the disk 
drives. This particular machine can 
receive serial data at 1200 baud, storing 
the incoming data on the disk and 
displaying it at the same time. The major 
system requirement for multi-processing 
is to partition all the jobs, defining very 
carefully the responsibility of each pro- 
cessor. In fact, it is like designing two 
separate systems and then designing an 
interface between the systems! Once all 
the system jobs have been passed out, 
you need to define the interface and 
decide how the information interchange 
wUl be handled. 

Some microprocessors have been 
designed specifically for multi- 
processing, such as the 6801 and 6809. 
Figure 1 shows just the interconnection 
of two 6801 uPs. The eight lines of Port 
P3 and the two SC lines combine to 
make a parallel link which transfers one 
byte at a time between the two devices. 
The SC lines form a handshake setup 
which informs the ' 'slave' ' processor that 
data is ready. Note that "slave" and 
"master" status is defined by which is 
programmed to send and which is pro- 
grammed to receive. The 6809 has a 
special pin called DMA/BREQ which 
allows other processors or special pur- 
pose hardware to request control of the 
data and address bus lines for fast data 
transfer or other purposes. The Radio 
Shack Color Computer uses the 6809E, 
which does not allow normal DMA or 
other types of bus access, since this 
would disturb the special relationship 
between the uP and the SAM (Syn- 
chronous Address Multiplier]. 

Another way to interface between 
processors is to define special areas of 
memory which can contain anything 
from a single bit or byte to whole pages 
of data. One processor must leave the 
data for the other, and set a flag which 
indicates the data is ready. The second 
processor will then pick up the data and 
cancel the flag. In practice, the memory 
bus must be segmented so that each 
processor has enough "private" 
memory for its own tasks, and the data 
buffer must be in address space which 
each processor can use. At the same 
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Figure 1: Some microprocessors, such as the Motorola 
6802 shown here, have built-in provisions for communica- 
tion between processors. 
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Figure 2: Two processors sharing some common memory 
area can use Interlocked latches to prevent bus conflict 
(see text). 
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Figure 3: A Digital-to-Anaiog converter cannot make accurate 
measurements without adequate resolution (see text). 
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time, there needs to be either interlock 
circuitry which prevents both pro- 
cessors from trying to access the area 
simultaneously, or the programming 
for both processors must enforce a 
similar protocol. This type of design 
almost always involves a dedicated pair 
of latches, and each latch will have a 
unique address controlled by one pro- 
cessor. This is illustrated in Figure 2; 
when uP#l is using the data buffer, it 
sets latch LI to the "off" state (Q = 0) 
by pulsing the CLEAR input. Li's Q 
output holds L2 in PRESET (Q high) as 
long as uP#l is accessing the buffer. At 
the same time, Li's /Q output is high, 
serving as a BUSY flag for uP#2. When 
uP#l releases the buffer, it pulses the 
clock line of LI, which sets LI to the 
"on" state, clears the busy flag and 
releases L2. Similar action by uP#2 
controls L2 and warns uP#l that the 
buffer is busy. It may also be important 
that the two processors have syn- 
chronized clock inputs. 

If two separate computers involved 
in a project must work together, one 
computer can be designated as the 
master, and it will send commands to 
the other computer over their link, 
which can be a high speed RS-232 line. 



The master must be programmed to 
pass the required commands to the 
slave computer, besides keeping its 
own business straight. It is likely that 
the slave will be assigned some kind of 
monitoring tasks, and the incoming 
commands will trigger interrupts on 
the slave. Then, depending upon the 
type of command, the slave may make 
a different measurement or report the 
previously collected data. Whatever the 
assigned tasks, part of the program- 
ming for both computers will involve 
specially coded commands to define 
precisely the nature of the task to 
be performed. 

That's enough on computer com- 
munications for now! I have promised 
to introduce some of the real-world 
hardware such as analog to digital 
(A/D) and digital to analog (D/A) con- 
verters. Very few processes and 
parameters we might be interested in 
are digital. We normally want to know 
how heavy, how strong, how loud, etc. 
something is. Natural processes come 
in all sizes, shapes and colors, and a 
precise measurement will usually in- 
volve values which do not change in 
discrete digital steps. 

Natural processes vary widely be- 
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Check the 

outstanding 

documentation 

supplied with 
AIM65 



from 

Ail prices 
Postpaid 

(Continental 
U.S. — 
otherwise 
$2 credit) 

Top quality power supply designed to Rockwell's specs for fully 
populated AIM 65 — Includes overvoltage protection, transient 
suppression, metal case and power cable: 
PSSBC-A (5V 2A Reg; 24V .5A Avg, 2.5A Peak, Unreg) ...$64.95 
Same but an extra AMP at 5 volts to drive your extra boards: 
PSSBC-3 (5V 3A Reg; 24V .5A Avg, 2.5A Peak, unreg) ...$74.95 

The professional's choice in microcomputers: 

AIM65/1K RAM .$429.95 BASIC (2 ROMS) $59.95 

AIM65/4K RAM $464.95 ASSEMBLER (1 ROM) . . $32.95 

FORTH (2 ROMS) $59.95. 

SAVE EVEN MORE ON COMBINATIONS 
AIM65/1K -I- PSSBC-A .$479.95 AIM65/4K-h PSSBC-3 .$524.95 

We gladly quote on all AIM65M0 and flM65 items as well. 
Mnpi ORDERS: (714) 369-1084 

\jSm P.O. Box 20054 • Riverside, CA 92516 

California residents add 6% sales tax 



tween two limits in such a way that a 
digital quantity will not be exactly cor- 
rect as shown in Figure 4. This diagram 
assumes an A/D converter with a full 
scale input of 16 volts and having a 
resolution of four bits (2»*4, or one 
part in 16) . In other words, each step of 
the converter represents a one volt 
change. If we assume the voltage to be 
measured is 9.5 volts, we find that step 
1001 (binary! is too low and step 1010 
is too high. Note that even if the 4 bit 
converter is 100% accurate, the best 
answer it can give for this measure- 
ment is incorrect by .5/9 or 5.5%. If we 
can increase the converter's resolution 
to 8 bits (2**8, or 1 part in 256), 9.5 
volts happens to be exactly 152 steps 
out of the 256 possible; the new con- 
verter has steps of 62.5 millivolts. At 
present, about the best resolution 
economically possible with an A/D 
converter is 16 bits (one part in 65536), 
or 244 microvolts if the full scale range 
were 16 volts as in our examples. Ac- 
tually, typical A/D converter ranges 
are - 5 volts, - 10 volts, or -5 to +5 
volts. If we don't have another reader 
question next month, we will get into 
types of A/D converters and do some 
experiments. 



You may contact Mr. Tenny at P.O. Box 
545, Richardson, TX 75080. 
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THIS IS VIC-20 BASIC 

ROBERT F. SUTHERLAND 
and RICHARD M. OILMAN 

Emphasizing good programming practices, the au- 
thors show how to take advantage of the VIC-20's 
special capabilities such as creation of shapes and 
pictures in color, and production of music and 
sound effects. 

1984 Paperback 420 pp.(approx.)ISBN:0-02-418380-6 $16.95 

AN INTRODUCTION TO 

STRUCTURED BASIC 

FOR THE CROMEMCO C-10 

WAYNE T WATSON 

The only book available in its area, this book as- 
sumes no prior programming experience and 
stresses interaction with the microcomputer. The 
first ten chapters provide a foundation to the most 
commonly used concepts in BASIC, and the last 
four chapters offer more advanced material on files 
and programming structures. 
1984 Paperback 276 pp (approx.) ISBN: 0-02-424580-1 $16.95 

BASIC-80ANDCP/M 

JACK JAY PURDUM 

The key features of BASIC-80® are related to the 
most popular microprocessor operating system, 
CP/M.'" Coverage includes sequential, random, 
and skip-sequential file structures and many use- 
ful subroutines for applied programs (binary 
searches; Shell and Bubble sort; range checks; 
direct cursor control for many popular CRT's; and 
error messages under direct cursor control). 
1984 Paperback 220 pp. ISBN: 0-02-397020-0 $16.95 

IBM-PC: 

8088 MACRO ASSEMBLER 

PROGRAMMING 

DAN ROLLINS, Independent Consultant 

Intended specifically for the increasingly popular 
IBM-PC, this book incorporates up-to-date sec- 
tions on IBM-PC color graphics and includes many 
sample programs. 

March, 1984 Paperback 300 pp. ISBN: 0-02-403210-7 
$13.95-tentative 

Prices subject to change without notice. 

AVAILABLE AT YOUR LOCAL 
BOOKSTORE 

FOR MORE INFORMATION CALL TOLL-FREE 



LM 



1-800-223-3215. OR WRITE: 

ACMILLA 



nJ 



, PUBLISHING COMPANY 
College Division • 866 Third Avenue • New York, NY 10022 



Advertiser Index 



A B Computers 88 

Amplify 36 

Atari Program Exchange 6 

CompuTech 94 

Computer Mail Order 76,77 

Datamost, Inc 92,93 

Eastern House Software 13 

Hollywood Hardware 89 

Incomm 42 

Interesting Software 38 

Kiwi Software 73 

Leading Edge Back Cover 

MacMillan Publishing Co 96 

Micro 75, 80 

Micro Spec 9 

Micro Ware 45 

Midwest Micro Inc 22 

Percom Data 3 

Performance Micro Products 59 

Perry Peripherals 72 

Protecto Enterprizes 30, 31, 32 

RH Electronics, Inc 91 

Richvale Telecommunications Inside Front 

SGC 86 

S J B Distributors 90 

Safeware 56 

Scientific Software 73 

Skyles Electric Works 19 

Spectrum Projects 70 

Star Micronics Inside Back Cover 

Strom Systems Inc 2 

Titan Technogies, Inc 20 

Totl Software 58 

Victory Software 21 

Winders & Geist, Inc 1 



National Advertising 
Representatives 



Home Office: 
Cindy Kocher, Advertising Manager 
P.O. Box 6502 
Chelmsford, MA 01824 



(617) 256-3649 



IVIid-West Territory: 

Thomas Knorr & Associates 
Tliomas H. Knorr, Jr. 

333 N. Michigan Avenue, Suite 401 
Chicago, Illinois 60601 (312) 726-2633 
serving: Ohio, Oklahoma, Arl<ansas, Texas, North Dalfota, South 
Dakota, Nebraska, Kansas, Missouri, Indiana, iiiinois, Iowa, 
Michigan, Wisconsin, and Minnesota. 

West Coast: 

The R.W. Walker Co., Inc. 
Gordon Carnie 

2716 Ocean Park Boulevard, Suite 1010, 
Santa Monica, California 90405 (213) 450-9001 

serving: Washington, Oregon, Idaho, Montana, Wyoming, Colorado, 
New Mexico, Arizona, Utah, Nevada, California, Alaska, and Hawaii 
(also British Columbia and Alberta, Canada) 



96 



MICRO 



No. 68 - January 1984 



The new pacesetter in professaoa 

The economical dual-speed RadJx45 multi-ftmcti(Hi prini 
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With a fast and furious work pace, a highly 
flexible printer is crucial. That printer is the new 
Radix-15. Watch it take your work and run with it. 

It's dual speed! At 200 cps Radix fires 
out a superbly refined dot matrix printout. At 50 
cps it prints professional near-letter quality So now 
you can go from spreadsheets to memos at the flip 
of a switch or at your computer's command. 

It's multi-functional! In either mode Radix- 
15 quickly adapts to your needs. There's serial and 
parallel interface. Memory storage with a 16K 
buffer Responsive throughput to help you use 



time more efficiently. Bi-directional performance. 
Friction and tractor feed. An automatic sheet 
feeder for letterheads and a short form tear-off 
for preprinted forms. Plus, the freedom to under- 
line, set vertical and horizontal tabs and print a 
huge variety of type faces. 

It's economical! And not only does Radix 
give you 2 printers in 1, it also gives you a price per- 
formance as outstanding as its working performance. 
The professional Radix-15. Using the ever- 
changing beat of business to your advantage. And 
that's what being a pacesetter is all about! 
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THE POWER BEHIND THE PRINTED WORa 

Computer Peripherals Division 
P.O. Box 612186, Oallas/Ft. Wbrth Airport, TX 75261 (214) 4S640S2 
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4 full line ofiof-ijuality flofvies, in virtually every 9'/)" MdS" model, for compatibility with virtually every commiteron the market. 
Guaranteed to meet or exceed every industry standard, certified 100% ertvr-free and frohlem-frte, and to maintain its t^ualtty for at least iZ million passes 

(or over a lifetime of heavy-duty use). b^^^^^^^ 

ContaaDetmison Computer Supplies, Inc., 55 Providence Hiehway, Norwood, MA 01061 or call toll-free i-800-343-841i. HLMUaUM 
In Massachusetts, call collect (617) 769-8i5Q. Telex 95i'624. 
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